Installing Comitup

The easiest way to get up and running with Comitup is to download the Comitup img file and burn it to an SD card.

If you prefer, you can install the package to an existing Raspbian installation:

1. Install the comitup package. It is included in Stretch and newer.

   sudo apt-get install comitup

   Newer(better) versions are available via the Comitup Repository.

2. Allow NetworkManager to manage the wifi interfaces by removing references to them from /etc/network/interfaces.

3. Rename or delete /etc/wpa_supplicant/wpa_supplicant.conf.

4. The systemd.resolved service should be disabled and masked.

5. If the dnsmasq service is installed, it should be disabled, or configured to avoid localhost and the comitup-managed interfaces.

6. Comitup uses a local configuration of the DHCP setup utility dnsmasq to handle the network configuration of devices connecting to the Comitup hotspot. If another service is camped on the DHCP port (67) for the hotspot wifi interface, Comitup's dnsmasq will not be able to start, and connected devices may not be able to negotiate a useful IP address. If this happens, the host port needs to be freed up. This may be fixed by masking the global dnsmasq.service ("systemctl mask dnsmasq.service").

7. Enable ssh by creating the file /boot/ssh.

8. Reboot.