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/ directory.

   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 require 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 disabled in the HOTSPOT state in preference of the comitup web service, and will
         be  enabled in the CONNECTED state.  This should be the name of the systemd web service,
         such as apache2.service or nginx.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 argument, 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)