d39f4ad267
De-duplicates the Ubuntu version/codename specs to simplify adding distributions. |
||
---|---|---|
.github/workflows | ||
debian | ||
.gitignore | ||
LICENSE | ||
README.md | ||
repository.asc |
README.md
Unofficial Innernet APT Repository
This is a Ubuntu/Debian APT repository containing .deb
files from https://github.com/tonarino/innernet/releases.
The updates are fully reproducible through GitHub Actions.
For more information, see https://github.com/tonarino/innernet.
Installation
Adding the Repository
codename=$(lsb_release --codename --short)
curl -sS https://tommie.github.io/innernet-debian/repository.asc | sudo tee /etc/apt/keyrings/github-tommie-innernet.asc >/dev/null
cat >/etc/apt/sources.list.d/innernet.list <<EOF
deb [signed-by=/etc/apt/keyrings/github-tommie-innernet.asc] https://tommie.github.io/innernet-debian/debian $codename contrib
EOF
apt update
Installing the Server
This is installed on the coordination server machine. It needs to be accessible from all peers.
$ sudo apt install innernet-server
Installing the Peer Client
This is installed on all peers.
$ sudo apt install innernet
Compatibility
We build for
- Ubuntu 22.04 (jammy)
- Ubuntu 20.04 (focal)
on
- amd64, x86_64
- armhf, armv7 (cross-build)
- arm64, aarch64 (cross-build)
Additionally:
- Debian 12 (bookworm) is served by
jammy
. There is a symlink in place to allowbookworm
, which will cause APT to warn that the codenames missmatch. In the end, either name works. - Debian 11 (bullseye) is served by
focal
. There is a symlink in place to allowbullseye
, which will cause APT to warn that the codenames missmatch. In the end, either name works.
The authoritative source of supported distributions and architectures is conf/distributions
.
Maintenance
Adding a Distribution
When Ubuntu/Debian releases a new version, we need to
- Add the new distribution in
debian/conf/distributions
. - Add the version and codename to the matrix in
build-deb
in.github/workflows/main.yml
.
License
The repository maintenance code itself is under the MIT License. See also LICENSE in tonarino/innernet.