Installing the State Tool

You can install the State Tool command line interface (CLI) on Windows, Linux, and macOS.

Installing on Windows

The State Tool installation requires PowerShell version 3.0 or higher. On older versions of Windows you will need to manually upgrade PowerShell to a supported version before completing the installation. For more information, see Upgrading existing Windows PowerShell.

  1. Start PowerShell as an Administrator. Click the Start menu, search for Windows PowerShell, right click it and select Run as Administrator.

  2. At the prompt, enter the following command:

    IEX(New-Object Net.WebClient).downloadString('https://platform.activestate.com/dl/cli/install.ps1')
    

    The latest version of the State Tool will be downloaded, verified, and installed.

  3. Start your command prompt (cmd.exe) to use the State Tool. Click the Start menu, search for Command Prompt, and click the menu item.

Currently, you cannot run the State Tool in PowerShell. You must use the command prompt (cmd.exe). PowerShell will be supported in a future release.

Installing on Linux

You should have curl installed before you run the script to install the State Tool. Alternatively, you can manually download and run the install.sh file.

  1. Open your command prompt and enter the following command on one line:

    sh <(curl -q https://platform.activestate.com/dl/cli/install.sh)
    

    The latest version of the State Tool will be downloaded, verified, and installed.

Installing on macOS

  1. Open your command prompt and enter the following command on one line:

    sh <(curl -q https://platform.activestate.com/dl/cli/install.sh)
    

    The latest version of the State Tool will be downloaded, verified, and installed.

Uninstalling the State Tool

You can uninstall the State Tool by running the state clean uninstall command. For more information, see the command reference.