Installing
There are two main methods for getting Orbit running on your computer: downloading a precompiled binary or by using Cargo.
Reminder: By installing and using Orbit, you accept usage under its GPL-3.0 license.
1. Using a precompiled binary
- Visit Orbit's releases page on Github to find all of its official releases.
- Download the binary for your computer's architecture and operating system.
- Install Orbit. Either run the provided
install
executable or follow the manual instructions for placing Orbit's executable (orbit
for Unix andorbit.exe
for Windows) in a location recognized by the PATH environment variable.
There are multiple solutions to accomplish step 3. The following outlines one way to manually install Orbit depending on the user's operating system.
Linux
- Download the latest prebuilt package.
curl -LO https://github.com/chaseruskin/orbit/releases/download/0.22.0/orbit-0.22.0-x86_64-linux.zip
- Unzip the prebuilt package.
unzip orbit-0.22.0-x86_64-linux.zip
- Move the executable to a location already set in the PATH environment variable.
mv ./orbit-0.22.0-x86_64-linux/bin/orbit /usr/local/bin/orbit
macOS
- Download the latest prebuilt package.
curl -LO https://github.com/chaseruskin/orbit/releases/download/0.22.0/orbit-0.22.0-x86_64-macos.zip
- Unzip the prebuilt package.
unzip orbit-0.22.0-x86_64-macos.zip
- Move the executable to a location already set in the PATH environment variable.
mv ./orbit-0.22.0-x86_64-macos/bin/orbit /usr/local/bin/orbit
Windows
-
Open a new terminal (Powershell) to where Orbit was downloaded.
-
Unzip the prebuilt package.
$ expand-archive "./orbit-0.22.0-x86_64-windows.zip"
- Make a new directory to store this package.
$ new-item -path "$env:LOCALAPPDATA/Programs/orbit" -itemtype directory
- Move the package to the new directory.
$ copy-item "./orbit-0.22.0-x86_64-windows/*" -destination "$env:LOCALAPPDATA/Programs/orbit" -recurse
- Edit the user-level PATH environment variable in Control Panel by adding %LOCALAPPDATA%\Programs\orbit\bin.
2. Installing with Cargo
To install the latest version through Cargo:
$ cargo install --git https://github.com/chaseruskin/orbit.git --tag 0.22.0
This will build the orbit
binary and place it a path already set in the PATH environment variable.
Checking if Orbit is installed correctly
To verify Orbit is working correctly on your system, let's open a new terminal session and print it's current version.
$ orbit --version
orbit 0.22.0
This should print out your version of Orbit you installed. Congratulations! You are now ready to begin using Orbit.