# Install Starport
You can run Starport in a web-based Gitpod IDE or you can install Starport on your local computer.
Starport is written in the Go programming language. To use Starport on a local system:
- Install Go (opens new window) (version 1.16 or higher)
- Ensure the Go environment variables are set properly (opens new window) on your system
Tip: If you get the message
appd: command not found then your Go environment variables might not be set correctly.
# Upgrading Your Starport Installation
Before you install a new version of Starport, remove all existing Starport installations.
To remove the current Starport installation:
- On your terminal window, press
Ctrl+Cto stop the chain that you started with
- Remove the Starport binary with
rm $(which starport). Depending on your user permissions, run the command with or without
- Repeat this step until all
starportinstallations are removed from your system.
After all existing Starport installations are removed, follow the Installing Starport with cURL instructions. For details on version features and changes, see the changelog.md (opens new window) in the repo.
# Installing Starport with cURL
starport binary is downloaded from the Github repo and installed in
To install previous versions of the precompiled
starport binary or customize the installation process, see Starport installer docs (opens new window) on GitHub.
# Write permission
Starport installation requires write permission to the
/usr/local/bin/ directory. If the installation fails because you do not have write permission to
/usr/local/bin/, run the following command:
Then run this command to move the
starport executable to
# Installing Starport on macOS with Homebrew
# Build from source
- To setup a local development environment, install Starport locally on your computer.
- Install Starport by fetching the binary using cURL, Homebrew, or by building from source.
- The latest version is installed by default. You can install previous versions of the precompiled
- Stop the chain and remove existing versions before installing a new version.