Supported platforms
gtcnsl is a single static binary with no runtime dependencies. Here are the architectures it ships for and the systems it is tested on.
Updated for v1.3.0
Architectures
Releases ship for three Linux architectures, named gtcnsl-v1.3.0-linux-<arch>:
| Arch | File suffix | Covers |
|---|---|---|
| amd64 | -linux-amd64 |
most cloud VPS and desktops |
| arm64 | -linux-arm64 |
modern ARM servers, Raspberry Pi 4/5 |
| armv7 | -linux-arm-7 |
32-bit ARM boards |
[!NOTE] The armv7 file is
-arm-7The 32-bit ARM build is published as…-linux-arm-7, notarmv7. The install snippet andself-updatealready use the right name for your machine.
Tested distributions
End-to-end tested on the systemd-based distros below. Other modern systemd distros are likely fine but unverified.
| Distro | Version | Arches |
|---|---|---|
| Debian | 13 | amd64 · arm64 |
| Ubuntu | 24.04 LTS | amd64 · arm64 |
| Rocky | 9 | amd64 · arm64 |
i
armv7 ships but isn't in the container matrix
The 32-bit ARM binary is built and published every release, but the
end-to-end systemd container tests run on amd64 and arm64 only — armv7 is
"likely fine but unverified", like the unlisted distros.
What the host needs
- systemd — gtcnsl manages
gitea.serviceandgitea-runner.service. - root for service operations (install, config apply, secrets). Read-only commands (
config get,doctor) do not need it. - outbound HTTPS to
dl.gitea.com(Gitea + runner downloads) andhttps://dl.gtcnsl.com(gtcnsl self-update).
The binary is built with CGO disabled, so there is nothing to install alongside it — no libc version to match, no interpreter.
i
Verify before you trust the host
gtcnsl doctor probes all of the above (systemd, HTTPS reachability, disk, privileges) and reports PASS / WARN / FAIL.Next steps
Ready to install? The Installation guide covers download, verification, and PATH.