Skip to content

Installation#

Command Line Interface (CLI)#

If dotnet.exe is already installed on your machine, simply run: 

1
    dotnet tool install automate --global

Info

The automate CLI above is dependent on having the dotnet.exe development tools (.NET 6.0 or higher) already installed on your machine. Installing dotnet. All versions of the automate CLI can be found on nuget.org

If you don't have dotnet.exe installed on your machine, or you don't want to install dotnet.exe, you can just install the automate CLI manually:

On Windows:

  1. Download the file automate-Win-x64.exe to your machine, from: Releases
  2. Remove "protection" for the downloaded file, by viewing the 'Properties' of the downloaded file in File Explorer and uncheck the 'Unblock' setting.
  3. Copy and rename (to: automate.exe) the file to somewhere on your local machine. Recommend: %USERPROFILE%\AppData\Local\Programs\automate.exe
  4. Edit your environment variables on Windows and add the folder %USERPROFILE%\AppData\Local\Programs to the Path variable.

On MacOS:

  1. Download the file automate-OSX-x64 to your machine, from: Releases
  2. Make the downloaded file executable: chmod a+x automate.OSX-x64
  3. Remove "protection" for the downloaded file: xattr -d com.apple.quarantine automate.OSX-x64
  4. Copy and rename (to: automate) the file somewhere that is in your PATH. For example: sudo cp automate.OSX-x64 /usr/local/bin/automate

On Linux (i.e Ubuntu):

  1. Download the file automate-Linux-x64 to your machine, from: Releases
  2. Make the downloaded file executable: chmod a+x automate.Linux-x64
  3. Copy and rename (to: automate) the file somewhere that is in your PATH. For example: sudo cp automate.Linux-x64 /usr/local/bin/automate

Info

On some distros of Linux you may need to install the following dependency: apt-get install libicu-dev. Other than that, you should be good to go.

Upgrading#

To upgrade the CLI to a specific version:

If dotnet.exe is already installed on your machine, simply run:

1
2
    dotnet tool uninstall automate -- global
    dotnet tool install automate --global --version x.y.z

If you don't have dotnet.exe installed on your machine, update the CLI manually:

  1. Download the executable to your machine with a later one from the Releases page
  2. Replace the previous version on your machine. Follow instructions above.