Getting Started

Citrus is a desktop app that runs on your computer and manages your servers. It takes care of setup, deployment, and everyday server tasks. On the server side, it uses popular open-source tools - no black boxes, no vendor lock-in.

How It Works

Here’s the usual workflow:

1. Install Citrus

   Download and install the desktop app.

2. Add Your Server

   Append your server to Citrus. It can be VPS, dedicated servers, or even a Raspberry Pi.

3. Create a Project

   Define what your app needs: domain, environment variables, build/run scripts, database, etc.

4. Deploy

   Citrus configures everything and brings your app to life.

Supported Platforms

Citrus supports the following platforms:

• macOS (Apple Silicon and Intel)
• Windows
• Linux (coming soon)

Server Side

Citrus supports next Linux distribution:

• Fedora 42 recommended
• Fedora 40 and newer
• Ubuntu 24.04 and newer
• Debian 12 and newer
• Raspberry Pi OS based on Debian 12 and newer

Citrus uses next tools to launch and manage your applications:

• systemd: service management and scheduling tasks.
• iptables: firewall management.
• Podman: containerization and isolation.
• Nginx: reverse proxy and serving static files.
• Fugo: managing logs and basic monitoring.