Installation

Acton ships as a single, dependency-free executable. You can install it via the public installer, by downloading a release asset directly, or by using the published Docker image.

Installation

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh

To confirm installation, open a new terminal window and run:

acton --version

The printed line is the Acton version.

Shell completions

Use acton completions to add suggestions for commands and contract names in the shells like Bash, Zsh, Fish, Elvish, and Nushell.

Agent skills

See the Acton skills overview for available agent skills and their installation.

Direct Downloads

To download Acton binaries directly, visit the releases page on GitHub or use the latest release links below:

Extract the acton binary from the archive:

tar xzf acton-arch-os-archive.tar.gz

Place the extracted binary to a common directory in PATH, e.g., ~/.local/bin or /usr/local/bin. Alternatively, place it in a different installation directory and manually add it to PATH:

Trunk releases

Acton publishes a trunk build for the preview channel. It includes changes before they land in the next stable numbered release.

To switch to the latest trunk build:

# Switch to trunk
acton up --trunk

# Switch back to stable
acton up --stable

If the project pins the CLI in Acton.toml, update the pin when switching to the preview channel:

[toolchain]
acton = "trunk"

Use trunk to try a new feature or verify a fix before it reaches stable. trunk builds may include regressions or incomplete work, so if something breaks there, check whether it also reproduces on the latest stable release.

Docker image

Acton is also published as a Docker image at ghcr.io/ton-blockchain/acton. This is useful for CI pipelines, ephemeral environments, or local workflows where you do not want to install the binary on the host machine.

To verify that the image is available and print the Acton version:

docker run --rm ghcr.io/ton-blockchain/acton:1.1.0 --version

To run Acton against the current project from a container:

docker run --rm \
  -v "$PWD":/workspace \
  -w /workspace \
  ghcr.io/ton-blockchain/acton:1.1.0 \
  build

Because the image uses acton as its entrypoint, replace build with any other Acton subcommand such as test, check, or fmt --check.

CI/CD

See the CI integration guide for GitHub Actions and GitLab CI examples.

Updating

Once Acton is installed, you can use the built-in acton up command to update to the latest version or switch between versions.

Update to latest stable

To update to the latest stable version, run:

acton up

List available versions

To see all available versions, including the trunk release:

acton up --list

Install a specific version

To install a specific version:

acton up <VERSION_NUMBER>

Uninstall

To uninstall Acton binaries or cache, remove the ~/.acton directory in the home folder. To also remove global wallets and libraries, delete the global config directory: ~/.config/acton.

Support policy

Acton is stable on the latest major numbered release.

Platform tiers