Skip to content
gtcnsl
EN RU

Documentation

Everything you need to install, run, and operate gtcnsl. Start with a clean install, then wire up CI in three commands.

// start here
Install in one command

Pull the static binary for your architecture, verify it, and you are ready.

See all releases →
$ curl -fsSL https://dl.gtcnsl.com/v2.1.1/gtcnsl-v2.1.1-linux-amd64 -o /usr/local/bin/gtcnsl && chmod +x /usr/local/bin/gtcnsl
// 01

Guides

Written guides land here; the rest arrive as the tool stabilises.

Installation →

Per-arch download, SHA-256 verification, and where the binary lives.

Quickstart →

Zero to a running Gitea with CI in three commands.

Configuration →

Declarative app.ini — render from a template, diff before you write, apply atomically with a backup and automatic rollback.

Secrets →

Generate, check, and rotate the four Gitea secrets in /etc/gitea/secrets.ini — kept separate from your config template.

systemd units →

The gitea and gitea-runner units gtcnsl installs, and the standard systemctl / journalctl commands to operate them.

Upgrades & self-update →

Keep gtcnsl current with verified self-update, move Gitea forward safely, and roll back when a release misbehaves.

TUI vs CLI →

When to reach for the interactive terminal UI and when to script the CLI — and why the bare command is safe in pipelines.

Supported platforms →

The distributions and architectures gtcnsl is tested on, and the handful of things the static binary needs from the host.

Troubleshooting & FAQ →

Read gtcnsl's exit codes and logs, run doctor, and fix the errors people hit first.

Configuration Soon

Declarative app.ini, diffs, and backups.

Secrets Soon

Generate, rotate, and store Gitea secrets.

systemd units Soon

Manage the gitea and gitea-runner units.

Upgrades & self-update Soon

Move Gitea and gtcnsl forward safely.

TUI vs CLI Soon

When to use the interactive UI and when to script.

Supported platforms Soon

Distros and architectures that are tested.

Troubleshooting / FAQ Soon

Common errors and how to read them.

i
Docs are expanding
gtcnsl ships a stable v1.x CLI. These pages grow with each release — the "Soon" guides are tracked, not forgotten.