innernet-debian/README.md

2.4 KiB

Unofficial Innernet APT Repository

Update 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 allow bookworm, 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 allow bullseye, 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

  1. Add the new distribution in debian/conf/distributions.
  2. Update .github/workflows/main.yml in
    • check-repo-release to find existing package versions,
    • build-deb matrix to build on the new version.

License

The repository maintenance code itself is under the MIT License. See also LICENSE in tonarino/innernet.