https://github.com/davesteele/comitup

Bootstrap Wifi support over Wifi
https://github.com/davesteele/comitup

bootstrap-wifi comitup hotspot pi raspberry raspberry-pi raspberry-pi-3 raspberry-pi-4 raspberrypi wifi zeroconf

Last synced: about 1 month ago
JSON representation

Bootstrap Wifi support over Wifi

• Host: GitHub
• URL: https://github.com/davesteele/comitup
• Owner: davesteele
• License: gpl-2.0
• Created: 2015-12-08T21:39:27.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2024-07-30T03:41:01.000Z (about 1 month ago)
• Last Synced: 2024-07-30T07:32:42.329Z (about 1 month ago)
• Topics: bootstrap-wifi, comitup, hotspot, pi, raspberry, raspberry-pi, raspberry-pi-3, raspberry-pi-4, raspberrypi, wifi, zeroconf
• Language: CSS
• Homepage: https://davesteele.github.io/comitup/
• Size: 14.4 MB
• Stars: 321
• Watchers: 20
• Forks: 54
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: COPYING

Awesome Lists containing this project

README

        


Comitup

======

[![Build Status](https://github.com/davesteele/comitup/actions/workflows/testnox.yml/badge.svg?branch=master)](https://github.com/davesteele/comitup/actions)

[Home Page](https://davesteele.github.io/comitup/)

[Wiki](https://github.com/davesteele/comitup/wiki)

Bootstrap Wifi using Wifi

-------------------------

The __comitup__ service establishes wifi connectivity for a headless Linux

system, using wifi as the only access mechanism to the system.

If the computer cannot automatically connect to a local wifi access point,

__comitup__ will create a custom hotspot, and establish a __comitup-web__

web service on that network. The web service can be used to remotely select

and authenticate a visible wifi connection. 

The hotspot is named _comitup-<nnn>_, where _<nnn>_ is a

persistent number. The website is accessible on that hotspot as

_ht​tp://comitup-<nnn>.local_

from any device which supports [Bonjour/ZeroConf/Avahi][zeroconf]. For

other devices, use a Zeroconf browser ([Android][], [Windows][]) to

determine the IP address of the "Comitup Service", and browse to

_http://<ipaddress>_. This address will be _http://10.41.0.1/_

The __comitup__ service implements a [captive portal](https://en.wikipedia.org/wiki/Captive_portal) while in HOTSPOT mode. On supported systems (IOS,

Android, MacOS, Linux, or anything running Firefox), the connection web

page will come up automatically when connecting to the access point.

Comitup can remember multiple upstream connections, and will search among them

in the connection attempt, making it easier to move your device to different

locations.

If two wifi interfaces are available, the first can persistently remain

the hotspot, and the second can manage the external connection. When both

are connected, forwarding and masquerading are enabled so that

hotspot-connected devices can access external networks.

On the Raspberry Pi, the comitup-web service, running in the hotspot mode,

supports a "Locate" feature that blinks the green led on the front of the unit.

[zeroconf]: https://en.wikipedia.org/wiki/Zero-configuration_networking

[Android]: https://play.google.com/store/apps/details?id=com.melloware.zeroconf&hl=en

[Windows]: http://hobbyistsoftware.com/bonjourbrowser

The __comitup-cli__ utility is available to interact with _comitup_ from a

local terminal session.

__comitup__ requires NetworkManager and systemd.

See the [Home Page](https://davesteele.github.io/comitup/) for installation information.

Man pages

---------

* [comitup.8](https://davesteele.github.io/comitup/man/comitup.pdf)

* [comitup-conf.5](https://davesteele.github.io/comitup/man/comitup-conf.pdf)

* [comitup-web.8](https://davesteele.github.io/comitup/man/comitup-web.pdf)

* [comitup-cli.1](https://davesteele.github.io/comitup/man/comitup-cli.pdf)