# Installation (/docs/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.

<Callout type="info" title="Support policy">
  Acton is stable on the latest major numbered release. First-class support covers versioned releases on macOS (ARM64 and x86\_64) and Linux GNU (x86\_64 and ARM64). For Linux, the documented baseline is Ubuntu 22 or newer.

  `trunk` builds, WSL installs, and other source-built targets are beta or best-effort surfaces. Native Windows is not supported: install Acton inside WSL with Ubuntu 22 or newer and follow the Linux steps.

  See the [platform tiers](#platform-tiers) for the full matrix.
</Callout>

## Installation [#installation]

<Tabs items="[&#x22;macOS&#x22;, &#x22;Linux&#x22;, &#x22;WSL&#x22;]">
  <Tab value="macOS">
    ```bash
    curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
    ```
  </Tab>

  <Tab value="Linux">
    ```bash
    curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
    ```
  </Tab>

  <Tab value="WSL">
    Run this inside the WSL shell with Ubuntu 22 or newer, not in PowerShell nor in `cmd.exe`:

    ```bash
    curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
    ```
  </Tab>
</Tabs>

<Callout type="warning" title="Use WSL on Windows">
  On Windows, use WSL with Ubuntu 22 or newer; native Windows is not supported.
</Callout>

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

```bash
acton --version
```

The printed line is the Acton version.

### Shell completions [#shell-completions]

Use [`acton completions`](/docs/commands/shell-completions) to add suggestions for commands and contract names in the shells like Bash, Zsh, Fish, Elvish, and Nushell.

### Agent skills [#agent-skills]

See the [Acton skills overview](/docs/agent-skills/overview) for available agent skills and their installation.

## Direct Downloads [#direct-downloads]

To download Acton binaries directly, visit the [releases page on GitHub](https://github.com/ton-blockchain/acton/releases) or use the latest release links below:

<Cards cols="2">
  <Card icon="<SiApple/>" title="macOS ARM64" href="https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-apple-darwin.tar.gz">
    Apple Silicon (M1/M2/M3/etc.)
  </Card>

  <Card icon="<SiApple/>" title="macOS x64" href="https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-apple-darwin.tar.gz">
    Intel Macs
  </Card>

  <Card icon="<SiLinux/>" title="Linux x64" href="https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-unknown-linux-gnu.tar.gz">
    Standard Linux x64 binary
  </Card>

  <Card icon="<SiLinux/>" title="Linux ARM64" href="https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-unknown-linux-gnu.tar.gz">
    Linux ARM64 binary
  </Card>
</Cards>

Extract the `acton` binary from the archive:

```bash
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`:

<Accordions>
  <Accordion title="Add Acton to the PATH">
    <Steps>
      <Step title="Determine which shell is active">
        ```bash
        echo $SHELL
        # /bin/zsh or /bin/bash or /bin/fish
        ```
      </Step>

      <Step title="Open the shell configuration file">
        * For bash: `~/.bashrc`
        * For zsh: `~/.zshrc`
        * For fish: `~/.config/fish/config.fish`
      </Step>

      <Step title="Add the Acton directory to PATH">
        Add this line to the configuration file:

        ```bash
        export PATH="PATH_TO_ACTON_BIN:$PATH"
        ```
      </Step>

      <Step title="Reload the shell configuration">
        ```bash
        source ~/.bashrc # or ~/.zshrc
        ```
      </Step>
    </Steps>
  </Accordion>
</Accordions>

## Trunk releases [#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:

```bash noCopy title="terminal"
# 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:

```acton-toml title="Acton.toml"
[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 [#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:

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

To run Acton against the current project from a container:

```bash
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 [#cicd]

See the [CI integration guide](/docs/ci-setup) for GitHub Actions and GitLab CI examples.

## Updating [#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 [#update-to-latest-stable]

To update to the latest stable version, run:

```bash
acton up
```

### List available versions [#list-available-versions]

To see all available versions, including the trunk release:

```bash
acton up --list
```

### Install a specific version [#install-a-specific-version]

To install a specific version:

```acton-cli
acton up <VERSION_NUMBER>
```

## Uninstall [#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 [#support-policy]

Acton is stable on the latest major numbered release.

### Platform tiers [#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        |

<Callout type="warn">
  Other source-built targets are outside of the official binary matrix: their validation is limited, and regressions may occur.
</Callout>