Installation

The only thing you need to use Satusky is the 1ctl binary. No Docker, no kubectl, no kubeconfig. Builds run in the cloud.

macOS

Homebrew (recommended):

brew install satusky/tap/1ctl

Direct download — replace VERSION with the latest release from the releases page:

curl -L "https://github.com/satusky/1ctl/releases/latest/download/1ctl_darwin_arm64.tar.gz" | tar xz
sudo mv 1ctl /usr/local/bin/

Use darwin_amd64 if you’re on an Intel Mac.

Linux

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

The install script detects your architecture (amd64 or arm64), downloads the correct binary, and places it in /usr/local/bin. You may need sudo depending on your system.

To install manually:

curl -L "https://github.com/satusky/1ctl/releases/latest/download/1ctl_linux_amd64.tar.gz" | tar xz
sudo mv 1ctl /usr/local/bin/

Windows

Download the .zip archive from the releases page, extract it, and add the directory to your PATH.

# Using winget
winget install Satusky.1ctl

WSL2 is supported — follow the Linux instructions inside your WSL environment.

Build from source

Requires Go 1.24 or later.

go install github.com/satusky/1ctl@latest

Make sure $(go env GOPATH)/bin is on your PATH.

Verify the installation

1ctl --version

Expected output:

1ctl version 1.x.x (commit abc1234, built 2026-04-27)

If you get command not found, confirm the binary is on your PATH:

which 1ctl

Shell completion

Tab completion is available for bash, zsh, and fish.

bash — add to ~/.bashrc:

eval "$(1ctl completion bash)"

zsh — add to ~/.zshrc:

eval "$(1ctl completion zsh)"

fish — add to ~/.config/fish/config.fish:

1ctl completion fish | source

After reloading your shell, 1ctl <TAB> will complete commands, flags, and resource names.