Installation
Learn how to install Acton
Overview
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.
Support policy
First-class support is currently limited to versioned releases on macOS
(ARM64 and x86_64) and Linux GNU (x86_64 and ARM64). For Linux, the
documented baseline is Ubuntu 20.04 or newer. trunk builds and
WSL installs are beta / best-effort surfaces today. Native Windows is not
supported. If you use Windows, install Acton inside WSL with Ubuntu 20.04
or newer and follow the Linux steps there. See platform tiers
for the full matrix.
After installation, verify with acton --version
Installation
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/i582/acton-public/releases/latest/download/acton-installer.sh | shcurl --proto '=https' --tlsv1.2 -LsSf https://github.com/i582/acton-public/releases/latest/download/acton-installer.sh | shRun this inside your WSL shell with Ubuntu 20.04 or newer, not in
PowerShell or cmd.exe.
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/i582/acton-public/releases/latest/download/acton-installer.sh | shWindows
Native Windows is not supported at the moment. On Windows, the recommended setup is WSL with Ubuntu 20.04.
To check that Acton was installed successfully, open a new terminal window and run:
acton --versionYou should see the version number of Acton.
If you've installed Acton but are seeing a command not found error, you
may have to manually add the installation
directory to your PATH.
Smart Completions
Setting up shell completions significantly simplifies working with the tool by providing smart suggestions for commands and contract names.
Direct Downloads
To download Acton binaries directly, visit the releases page on GitHub or use the latest release links below.
macOS ARM64
Apple Silicon (M1/M2/M3/etc.)
macOS x64
Intel Macs
Linux x64
Standard Linux x64 binary
Linux ARM64
Linux ARM64 binary
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:<version> --versionTo run Acton against the current project from a container:
docker run --rm \
-v "$PWD":/workspace \
-w /workspace \
ghcr.io/ton-blockchain/acton:<version> \
buildBecause 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, simply run:
acton upList available versions
To see all available versions, including the trunk release:
acton up --listInstall a specific version
To install a specific version:
acton up 0.1.5Switch to trunk
If you want to try the latest features before they are officially released, you can install the trunk version:
acton up --trunkUninstall
To uninstall Acton binaries/cache, remove the .acton directory in your home folder:
rm -rf ~/.actonIf you also want to remove global wallets and libraries, remove the global config directory too:
rm -rf ~/.config/actonSupport policy
Acton is currently released as a public beta.
Platform tiers
| Platform / environment | Tier |
|---|---|
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 Windows | Unsupported |
| Windows via WSL | Beta |
| Other source-built targets | Beta |
Other source-built targets are outside the official binary matrix; validation is limited and regressions may occur.
Last updated on