NAME

       comitup.conf - Comitup configuration file format

   DESCRIPTION
       The  comitup.conf file configures the wifi management service comitup(8).  It is located in the /etc/ di‐
       rectory.

   PARAMETERS
       • ap_name: By default, comitup will create a hotspot named comitup-<nn>, and publish avahi-daemon(8) host
         entries for comitup-<nn> and comitup.  Setting this entry will change the comitup string  with  one  of
         the  users  choosing.   If  the configuration variable contains an <nn> string, with one to 4 “n’s”, it
         will be replaced with a persistent, random number.  Similarly, the string <hostname> is  replaced  with
         the computer’s hostname.

       • ap_password:  If this parameter is defined in the configuration file, then the comitup hotspot will re‐
         quire that any connection to the hotspot be authenticated, using this password.

       • web_service: This defines a user web service to be controlled by comitup.  This service  will  be  dis‐
         abled  in  the  HOTSPOT state in preference of the comitup web service, and will be enabled in the CON‐
         NECTED state.  This should be the name of the systemd web  service,  such  as  apache2.service  or  ng‐
         inx.service.  This defaults to a null string, meaning no service is controlled.

       • enable_appliance_mode:  By default, comitup will use multiple wifi interfaces, if available, to connect
         to the local hotspot and to the internet simultaneously.  Setting this to something other  than  “true”
         will limit comitup to the first wifi interface.

       • external_callback:

         The path to an external script that is called on comitup state changes.  It will include a single argu‐
         ment,  either  `HOTSPOT',  `CONNECTING',  or  `CONNECTED'.   The script will run as the owning user and
         group.

       • primary_wifi_device;

         Override the default choice for the primary WiFi device to use.

   COPYRIGHT
       Comitup is Copyright (C) 2016-2019 David Steele <steele@debian.org>

   SEE ALSO
       comitup(8), comitup-cli(8), comitup-web(8)

                                                  February 2019                                  comitup-conf(5)