Getting started

The Actyx Command Line Interface (CLI) is a unified tool to manage your ActyxOS nodes and apps. With the Actyx CLI, you can interact with your ActyxOS environment by running commands in your favourite terminal program:

  • Linux or macOS: Use common shell programs such as bash, zsh or tcsh to run commands in linux shells.
  • Windows: On Windows, run commands with the Windows command prompt or in PowerShell

Installation

no help needed?

If you already know how to install command line tools, you can directly go to our downloads page and download the binary file for the Actyx CLI.

This section describes how to install the Actyx CLI. Just choose your operating system and follow the instructions:

Requirements

  • 64-bit version of Windows
  • Admin rights to run the Windows installer

Installing the Actyx CLI

  1. Download the Actyx CLI MSI installer for Windows on our downloads page. By default, the Actyx CLI installs to C:\Program Files\Actyx\Actyx CLI X.X.X\

  2. Run the downloaded MSI installer and follow the onscreen instructions

  3. To confirm the installation, use the ax --version command in PowerShell or a command prompt (open the Start menu and search for PowerShell or cmd to start them). You should see something like this:

C:\> ax --version
Actyx CLI 1.0.0-RC1

If you have problems with installing the Actyx CLI, please check our troubleshooting section.

Uninstalling the Actyx CLI

To uninstall the Actyx CLI, open the Control Panel, go to Settings and then to Apps. Select the Entry named Actyx CLI, and then choose Uninstall to launch the uninstaller. Confirm that you want to uninstall the Actyx CLI when you're prompted.

Troubleshooting

If you have any issues or just want to give feedback on our quickstart guide, you are welcome to join our Discord chat or write us an e-mail to [email protected] .