Installation

SatuSky builds container images remotely, so a normal application deployment does not require a local Docker daemon, kubectl, or a kubeconfig.

macOS

With Homebrew:

brew install satusky/tap/1ctl

Or download the archive for your architecture from the 1ctl releases page, extract it, and place 1ctl on your PATH.

Use the darwin_arm64 archive on Apple silicon and darwin_amd64 on Intel.

Linux

curl -fsSL https://get.satusky.com/install.sh | sh

The installer selects linux_amd64 or linux_arm64 and verifies the release checksum. If /usr/local/bin is not writable, follow the installer’s prompt or install the downloaded binary in a user-owned directory on PATH.

Windows

Download the Windows archive from the 1ctl releases page, extract it, and add its directory to PATH. WSL2 users can follow the Linux instructions inside WSL.

Build the current source checkout

A source build requires Go 1.24 or later:

git clone https://github.com/SatuSkyCloud/1ctl.git
cd 1ctl
go build -o bin/1ctl ./cmd/...
./bin/1ctl --version

Verify the installation

1ctl --version
1ctl --help

If the shell cannot find the command, inspect the resolved binary:

command -v 1ctl

Shell completion

The tested installer supports bash, zsh, fish, and PowerShell:

1ctl completion install

It detects the current shell and prints any one-time shell configuration that is still required.

To generate a completion script without installing it:

1ctl completion bash
1ctl completion zsh
1ctl completion fish
1ctl completion powershell