Sign in

Install spgctl

Legacy

Legacy SPGCLI (`spgctl`) installation from binaries or source, plus environment requirements.

Updated: March 5, 2026

SPGCLI (spgctl) is a legacy CLI. For new user scenarios, use Console or API; the installation notes below are kept only for compatibility with existing environments.

What you need for installation

There are two common scenarios:

Prebuilt binary

If your team or SPG99 distribution already provides a compiled binary, it is enough to:

  1. place spgctl in a directory included in PATH;
  2. verify the version:
spgctl --version

Build from source

If you install the CLI from source, you need a Rust toolchain and access to the build dependencies.

Example installation:

cargo install --locked --path apps/spgctl

or:

make install-spgctl

After that, make sure the directory with binaries, such as $HOME/.cargo/bin, is included in PATH.

What to configure after installation

In most cases, two environment variables are enough:

export CP_URL="https://provisioner.spg99.ru"
export SPG99_TOKEN="<api-key>"

Then verify access:

spgctl ping --json

Important

  • SPG99_TOKEN is the API key for the Control Plane;
  • tenant credentials and the DSN are used separately for PostgreSQL connections;
  • for new workflows, prefer Console and API;
  • the CLI itself does not replace psql and is not used as an SQL client.
Why SPG99ArchitectureRoadmapDocumentationBlog