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/v1.3.0/gtcnsl-v1.3.0-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.