Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ton-blockchain/acton/llms.txt

Use this file to discover all available pages before exploring further.

Acton ships as a single, dependency-free executable that you can install in seconds. The recommended path is the public one-line installer, which handles downloading the correct binary for your platform, placing it on your PATH, and setting up the shell environment. Alternatively, download a release asset directly or pull the published Docker image for containerised workflows.

​
One-line installer

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
Native Windows is not supported. On Windows, install Acton inside WSL with Ubuntu 20.04 or newer and follow the Linux steps above.
After the installer finishes, open a new terminal window and verify the installation: 
acton --version
The printed line is the installed Acton version.

​
Manual download

If you prefer to download a pre-built binary directly, use the latest release assets below.
PlatformArchitectureDownload
macOSARM64 (Apple Silicon)acton-aarch64-apple-darwin.tar.gz
macOSx86_64 (Intel)acton-x86_64-apple-darwin.tar.gz
Linuxx86_64acton-x86_64-unknown-linux-gnu.tar.gz
LinuxARM64acton-aarch64-unknown-linux-gnu.tar.gz
After downloading, extract the archive and move the binary to a directory on your PATH: 
# Extract the archive (replace the filename with the one you downloaded)
tar xzf acton-aarch64-apple-darwin.tar.gz

# Move the binary to a common location on PATH
mv acton ~/.local/bin/
1

Determine your active shell

echo $SHELL
# /bin/zsh  or  /bin/bash  or  /bin/fish
2

Open your shell configuration file

  • Bash: ~/.bashrc
  • Zsh: ~/.zshrc
  • Fish: ~/.config/fish/config.fish
3

Add the Acton directory to PATH

Append this line, replacing PATH_TO_ACTON_BIN with the actual directory:
export PATH="PATH_TO_ACTON_BIN:$PATH"
4

Reload the shell configuration

source ~/.bashrc   # or ~/.zshrc

​
Docker image

Acton is 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. Verify that the image works and print the Acton version: 
docker run --rm ghcr.io/ton-blockchain/acton:<version> --version
Run Acton against the current project directory from a container: 
docker run --rm \
  -v "$PWD":/workspace \
  -w /workspace \
  ghcr.io/ton-blockchain/acton:<version> \
  build
Because the image uses acton as its entrypoint, replace build with any other subcommand such as test, check, or fmt --check.
Replace <version> with the specific release tag you want to use, for example 1.1.0. Pinning the version in CI ensures reproducible builds.

​
Verifying the installation

acton --version
The output should be a single version line, for example: 
acton 1.1.0
If the command is not found, confirm that the directory containing the acton binary is listed in $PATH and that you opened a new shell session after installation.
Run acton doctor to print a diagnostic report covering resolved paths, manifest status, standard-library health, and relevant environment variables. This is the first thing to run when something looks wrong.

​
Updating Acton

Once Acton is installed, use the built-in acton up command to update to the latest release or switch between versions. 
acton up
trunk builds may include regressions or incomplete features. Use them to try upcoming changes before they land in a stable release, but always verify that a bug also reproduces on the latest stable before filing a report.

​
Uninstalling

To remove Acton binaries and cache, delete the ~/.acton directory. To also remove global wallets and library configuration, delete ~/.config/acton: 
rm -rf ~/.acton
rm -rf ~/.config/acton

​
Support policy

Acton is stable on the latest numbered GitHub release. The first-class platform matrix is:
Platform / EnvironmentTier
macOS ARM64 (aarch64-apple-darwin)First-class
macOS x86_64 (x86_64-apple-darwin)First-class
Linux x86_64 GNU (x86_64-unknown-linux-gnu)First-class
Linux ARM64 GNU (aarch64-unknown-linux-gnu)First-class
Native WindowsUnsupported
Windows via WSLBeta
Other source-built targetsBeta
For Linux, the documented baseline is Ubuntu 20.04 or newer. trunk builds, WSL installs, and other source-built targets are beta or best-effort surfaces — their validation is limited and regressions may occur.
Shell completions for Bash, Zsh, Fish, Elvish, PowerShell, and Nushell can be enabled with acton completions <shell>. See acton completions --help for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us