Installation
gtcnsl is a single static binary. Download it for your architecture, verify it, make it executable — done.
Download
There is nothing to compile and no runtime to install. Pick the build that matches your machine and pull it with curl.
$ curl -fsSL https://dl.gtcnsl.com/v0.6.3/gtcnsl-v0.6.3-linux-amd64 -o /usr/local/bin/gtcnsl && chmod +x /usr/local/bin/gtcnsl
amd64 covers most cloud VPS and desktops; arm64 covers modern ARM servers and the Raspberry Pi 4/5; armv7 covers 32-bit ARM boards.
Verify the download
Every release ships a checksums.txt with the SHA-256 of each binary. Pull it next to your download and check they match — the same SHA-256 check gtcnsl's own self-update runs before swapping the binary.
curl -fsSLO https://dl.gtcnsl.com/v0.6.3/checksums.txt
sha256sum --check --ignore-missing checksums.txt
--ignore-missing checks only the files you actually downloaded against the manifest, so a single-arch pull still verifies cleanly (it skips the other arches listed in checksums.txt).Put it on PATH
The install snippet already writes to /usr/local/bin/gtcnsl and sets the executable bit. If you downloaded by hand, do it explicitly:
sudo install -m 0755 gtcnsl-v0.6.3-linux-amd64 /usr/local/bin/gtcnsl
gtcnsl config get, gtcnsl doctor) do not.Confirm it runs
gtcnsl version
You should see the version, build commit, and target arch. If the command is not found, your shell has not picked up /usr/local/bin yet — open a new session.
Supported platforms
gtcnsl is tested on the distributions and architectures below. Other modern systemd-based Linux distros are likely fine but unverified.
| Distro | Version | Arches |
|---|---|---|
| Debian | 13 | amd64 · arm64 · armv7 |
| Ubuntu | 24.04 LTS | amd64 · arm64 |
| Rocky | 9 | amd64 · arm64 |
Next steps
With the binary on PATH, you are three commands away from a running Gitea with CI.