.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "comitup\-conf" "5" "April 2018" "" ""
.hy
.SH NAME
.PP
comitup.conf \- Comitup configuration file format
.SS DESCRIPTION
.PP
The \f[I]comitup.conf\f[] file configures the wifi management service
comitup(8).
It is located in the \f[I]/etc/\f[] directory.
.SS PARAMETERS
.IP \[bu] 2
\f[I]ap_name\f[]: By default, comitup will create a hotspot named
\f[B]comitup\-<nn>\f[], and publish avahi\-daemon(8) host entries for
\f[B]comitup\-<nn>\f[] and \f[B]comitup\f[].
Setting this entry will change the \f[B]comitup\f[] string with one of
the users choosing.
If the configuration variable contains an <nn> string, with one to 4
\[lq]n's\[rq], it will be replaced with a persistent, random number.
.IP \[bu] 2
\f[I]web_service\f[]: This defines a user web service to be controlled
by \f[B]comitup\f[].
This service will be disabled in the \f[B]HOTSPOT\f[] state in
preference of the comitup web service, and will be enabled in the
\f[B]CONNECTED\f[] state.
This should be the name of the systemd web service, such as
\f[I]apache2.service\f[] or \f[I]nginx.service\f[].
This defaults to a null string, meaning no service is controlled.
.IP \[bu] 2
\f[I]enable_appliance_mode\f[]: 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 \[lq]true\[rq] will limit comitup
to the first wifi interface.
.IP \[bu] 2
\f[I]external_callback\f[]:
.RS 2
.PP
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.
.RE
.IP \[bu] 2
\f[I]primary_wifi_device\f[];
.RS 2
.PP
Override the default choice for the primary WiFi device to use.
.RE
.SS COPYRIGHT
.PP
Comitup is Copyright (C) 2016\-2017 David Steele <steele\@debian.org>
.SS SEE ALSO
.PP
comitup(8), comitup\-cli(1), comitup\-web(8)