Comitup

Wifi Network Bootstrap for the Raspberry Pi

Comitup is a software package that provides a service to establish Wifi networking on a headless computer (that is, one with no video, keyboard, or mouse).

The Comitup Image is a microSD disk image for the Raspberry Pi, providing an operating system with the comitup service included. The Comitup Image is an extension of standard Raspberry Pi OS with the following capabilities:

• The comitup service, which automatically connects to any previously established Wifi Access Points, if possible. Otherwise, it will create a stand-alone Access Point with the name (SSID) 'comitup-<nnn>', where '<nnn>' is a unique, persistent number.
• Defined ZeroConf mdns address name for 'comitup-<nnn>.local', advertising the IP address of the Raspbery Pi on all interfaces.
• A comitup-web service, which provides a web interface for selecting and authenticating against an existing Access Point.
• A captive portal, facilitating discovery of the web service on systems that support it.
• If two wifi interfaces are available on the device, the comitup hotspot will remain on one, and the other will be used for the upstream connection. Routing/masquerading between the two networks is established automatically.
• A comitup-cli command-line utility for interacting with comitup.
• The ssh service is enabled by default. Be sure to change the "pi" user password
• The Raspberry Pi Ethernet port will automatically configure for the host network if possible. If a DHCP server is not found, the port will set to a static configuration, with an IP address of 10.0.0.2/24 and a default route of 10.0.0.1.

Getting Comitup

You can get Comitup by installing the package, or by downloading a Raspberry Pi OS image including the package (the preferred method).

Package Installation

• Raspberry Pi OS/Debian users can install the package with "sudo apt-get install comitup" (though Buster users shouldn't - more up-to-date-versions of the comitup package are highly recommended).
• New package versions are available in the Package Archive or the comitup PPA repository.
• Remove any references to wifi interfaces in "/etc/network/interfaces" so that Network Manager/Comitup can manage them.
• See Installing Comitup for other possible installation issues.

Comitup Image

To burn onto an SD card for the Raspberry Pi.

• Comitup Image (3.9 GB, 1.2 GB compressed)
  
  • Download | Torrent | Magnet
  • SHA1 | PGP
  • Info
• Comitup Lite Image (1.9 GB, 478 MB compressed)
  
  • Download | Torrent | Magnet
  • SHA1 | PGP
  • Info

Documentation

• The Comitup Wiki (with Tutorial).
• Man pages
  • comitup (8) (pdf)
  • comitup-conf (5) (pdf)
  • comitup-web (8) (pdf)
  • comitup-cli (8) (pdf)
• Changelog

Support/Feedback

• Issues