Go to file
lemoer 3f7c0b3ae8
gluon-mesh-vpn-wireguard: add package (#2168)
The address of the vpn interface is calculated in the style of
modified EUI-64, based on a virtual mac address. This virtual mac
address consists of 0x00 as first byte and the other five bytes
are taken from the first bytes of md5sum(base64 encoded public key).

The algorithm was taken by the ffmuc, with a slight difference. ffmuc
calculated the result of md5sum(base64 encoded public key + '\n')
which was interpreted as accidential fault and therefore dropped.

Example:
- Public-Key: "gP3VJnTTvnQut+z4O+m0N9RgMyXbgyUbUkF3E3TKX2w="
- Address: "fe80::02ca:b8ff:fedc:2eb3"

The following interfaces are used for wireguard:
- wg_mesh  -> wireguard interface
- mesh-vpn -> vxlan iface on top of wg_mesh

If you use this new feature, make sure the NTP servers in your site
config are publicly reachable. This is necessary, since wireguard
requires correct time before the vpn connection is established.
Therefore gluon performs ntp time synchronisation via WAN before it
establishes the vpn connection. Therefore the NTP servers have to
be publicly reachable (and not only via mesh).
2021-09-15 01:25:59 +02:00
.github actions: update checkouts to v2 2021-08-10 22:16:08 +02:00
contrib contrib/ci/minimal-site: build with owe and wpa3 support 2021-09-06 02:37:45 +02:00
docs ramips-mt7621: add support for Ubiquiti UniFi 6 Lite (#2310) 2021-09-15 00:44:34 +02:00
package gluon-mesh-vpn-wireguard: add package (#2168) 2021-09-15 01:25:59 +02:00
patches gluon-mesh-vpn-wireguard: add package (#2168) 2021-09-15 01:25:59 +02:00
scripts scripts: add update-modules helper (#2294) 2021-08-15 01:32:05 +02:00
targets ramips-mt7621: add support for Ubiquiti UniFi 6 Lite (#2310) 2021-09-15 00:44:34 +02:00
tests tests: respondd: update shebang to use the environments python3 version 2020-04-29 22:28:00 +02:00
.editorconfig .editorconfig: bunch of additions 2021-04-28 01:01:35 +02:00
.gitignore .gitignore: add files created when mounting repo in docker 2020-03-09 08:30:33 +01:00
.luacheckrc features: fix handling of logical expressions 2020-08-28 22:27:38 +02:00
.readthedocs.yml docs: add .readthedocs.yml to set Python version and requirements.txt 2021-06-26 20:39:22 +02:00
CONTRIBUTING.md CONTRIBUTING.md: fix link to list of rejected features (#1785) 2019-07-13 14:32:41 +02:00
LICENSE LICENSE: update for 2021 2021-01-02 19:10:18 +01:00
Makefile scripts: add update-modules helper (#2294) 2021-08-15 01:32:05 +02:00
README.md README.md: add a teaster, update state of documentation 2021-06-11 00:32:39 +02:00
modules modules: update Gluon packages 2021-09-15 01:07:19 +02:00

README.md

Build Gluon License GitHub release (latest SemVer)

Gluon

Gluon is a firmware framework to build preconfigured OpenWrt images for public mesh networks.

Getting started

We have a huge amount of documentation over at https://gluon.readthedocs.io/.

If you're new to Gluon and ready to get your feet wet, have a look at the Getting Started Guide.

Gluon's developers frequent an IRC chatroom at #gluon on hackint. There is also a webchat that allows for uncomplicated access from within your browser.

Issues & Feature requests

Before opening an issue, make sure to check whether any existing issues (open or closed) match. If you're suggesting a new feature, drop by on IRC or our mailinglist to discuss it first.

We maintain a Roadmap for the future development of Gluon.

Use a release!

Please refrain from using the master branch for anything else but development purposes! Use the most recent release instead. You can list all releases by running git tag and switch to one by running git checkout v2021.1 && make update.

If you're using the autoupdater, do not autoupdate nodes with anything but releases. If you upgrade using random master commits the nodes might break eventually.

Mailinglist

To subscribe to the list, send a message to:

gluon+subscribe@luebeck.freifunk.net

To remove your address from the list, just send a message to the address in the List-Unsubscribe header of any list message. If you haven't changed addresses since subscribing, you can also send a message to:

gluon+unsubscribe@luebeck.freifunk.net