Installation

Orbit ships as a desktop application. On Linux you can run the portable AppImage, install a native package for your distribution, or build from source. macOS and Windows builds are not attached to releases yet.

Requirements

AppImage (recommended)

The AppImage is a single portable executable and the recommended download for most Linux users. It needs no installation — download it from the releases page, make it executable, and run it.

1. 1

   Download the AppImage

   Grab Orbit-1.0.0.AppImage from the releases page.

2. 2

   Open a terminal in the download folder

   For example, cd ~/Downloads.

3. 3

   Make it executable

   Run chmod +x Orbit-1.0.0.AppImage.

4. 4

   Run Orbit

   Run ./Orbit-1.0.0.AppImage.

chmod +x Orbit-1.0.0.AppImage
./Orbit-1.0.0.AppImage

Debian / Ubuntu (.deb)

For Ubuntu, Debian, Linux Mint, Pop!_OS, and other Debian-based distributions, install the .deb with apt so dependencies resolve automatically:

sudo apt install ./Orbit-1.0.0.deb

If your system cannot install local files directly, use sudo dpkg -i Orbit-1.0.0.deb, then run sudo apt-get install -f to fix any missing dependencies.

Arch Linux (pacman)

For Arch Linux and compatible distributions, install the package with pacman:

sudo pacman -U Orbit-1.0.0.pacman

Build from source

Clone the repository and install dependencies with your package manager of choice. Bun is recommended because it matches the committed lockfile.

git clone https://github.com/dagisolo10/Orbit.git
cd Orbit
bun install

git clone https://github.com/dagisolo10/Orbit.git
cd Orbit
npm install

Run it

Start Orbit in development mode with hot reload:

bun run dev
# or
npm run dev

Build a distributable

To produce a production build or package a platform-specific artifact:

bun run build          # type-check then build
bun run build:unpack   # unpacked build, great for testing
bun run build:linux    # Linux packages (AppImage, deb, pacman)
bun run build:mac      # macOS DMG
bun run build:win      # Windows installer