79 lines
2.4 KiB
Markdown
79 lines
2.4 KiB
Markdown
# Unofficial Innernet APT Repository
|
|
|
|
[](https://github.com/tommie/innernet-debian/actions/workflows/main.yml)
|
|
|
|
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
|
|
|
|
```sh
|
|
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.
|
|
|
|
```shell
|
|
$ sudo apt install innernet-server
|
|
```
|
|
|
|
### Installing the Peer Client
|
|
|
|
This is installed on all peers.
|
|
|
|
```shell
|
|
$ 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`](https://github.com/tommie/innernet-debian/blob/main/debian/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`.
|
|
1. 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](https://github.com/tonarino/innernet/blob/main/LICENSE).
|