Selfhosting

Self-Hosting

Orbit can be self-hosted on your own infrastructure. For most installations, Docker is recommended because it simplifies dependency installation, database configuration, Prisma setup, and running Orbit.

System Requirements

Orbit is designed to run on a small Linux server. The following are the minimum practical requirements:

Resource	Minimum	Recommended
CPU	2 cores	2–4+ cores
RAM	2 GB	4 GB+
Storage	10 GB	20 GB+ SSD
Database	Prisma-compatible SQL database	PostgreSQL
Node.js	20+	Latest supported LTS
OS	Linux	Linux

SSD strongly recommended

Orbit's dependencies can consume a significant amount of disk space, particularly when installing node_modules. Next.js builds can also perform considerable disk I/O.

The minimum requirements represent the lowest practical configuration for running Orbit and are not recommended for production. For production installations, we recommend at least 4 GB of RAM and SSD storage.

Database

Orbit requires a SQL database supported by Prisma.

PostgreSQL is recommended.

MongoDB is not supported. Orbit's database layer is built around Prisma's SQL-compatible database interface and does not support MongoDB's NoSQL database model.

Software Stack

Orbit is built using the following technologies:

• Frontend: Next.js and Tailwind CSS
• Backend: Next.js API Routes
• ORM: Prisma
• Database: Any Prisma-compatible SQL database, with PostgreSQL recommended
• Package Manager: pnpm

Docker (Recommended)

We recommend running Orbit through Docker for self-hosted installations.

The Docker setup handles much of the configuration required to run Orbit

Installation

Clone the Orbit repository:

git clone https://github.com/PlanetaryOrbit/orbit.git 
cd orbit

Create and configure your environment file (.env) as described in .env.example.

Then start the Docker deployment:

docker compose up -d

Docker will build and start the required services.

The exact Docker configuration may change between Orbit releases. Check the repository's current docker-compose.yml and environment configuration before deploying.