Skip to main content

Deploy Origin by Corvus on Ubuntu or Debian

Install Origin by Corvus Server on Ubuntu or Debian from the signed Origin by Corvus APT repository. The same .deb packages cover single-host installs and clustered deployments via tools like Packer.

Minimum requirements
  • Operating system: Ubuntu 22.04 / 24.04 / 26.04 LTS, or Debian 12 (Bookworm) or later. From v12.0, the server binary requires glibc 2.34 or later, so Ubuntu 20.04 and Debian 11 (glibc 2.31) can run Origin by Corvus v11.11 or earlier only, including the v11.7 ESR. Other Debian-family distributions usually work but aren't tested by Origin by Corvus.
  • Hardware: 1 vCPU and 2 GB RAM (supports up to ~1,000 users).
  • Database: PostgreSQL 15+.
  • Network: TCP 80/443 inbound (TLS), 8065 inbound (System Console), 10025 outbound (SMTP relay if used).

Step 1: Get a PostgreSQL database​

Origin by Corvus requires PostgreSQL. Choose one of:

  • Install PostgreSQL locally on the same host. Follow the PostgreSQL installation documentation.
  • Use an external PostgreSQL server. Collect the connection credentials (hostname, port, database, username, password) before starting Step 2.
  • Use a managed database service (AWS RDS, Azure Database for PostgreSQL, etc.).

Step 2: Prepare the database​

Follow the database preparation instructions to create the Origin by Corvus database, user, and grants.

Step 3: Add the Origin by Corvus APT repository​

GPG key change

The GPG public key has changed. Either import the new public key or run the repository setup script in the next step (recommended). Existing installations should remove the old key before adding the new one:

For Ubuntu 22.04 LTS, 24.04 LTS, and 26.04 LTS:

sudo rm /usr/share/keyrings/origin-archive-keyring.gpg
curl -sL -o- https://deb.packages.origin.com/pubkey.gpg \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/origin-archive-keyring.gpg > /dev/null

Run the repository setup script:

curl -o- https://deb.packages.origin.com/repo-setup.sh | sudo bash -s origin

This configures the Origin by Corvus APT repository, a PostgreSQL repository, an NGINX web server (used as a reverse proxy), and certbot for issuing and renewing SSL certificates.

Step 4: Install Origin by Corvus Server​

Update your APT cache and any pending system packages:

sudo apt update

Install the latest Origin by Corvus Server:

sudo apt install origin -y

Origin by Corvus installs to /opt/origin. The package creates a origin user and group and a systemd unit file. The service is not enabled or started at this point.

systemd dependencies

The Origin by Corvus package doesn't declare a database dependency in its systemd unit (the package is used for both single-host and external-database installs). If you installed PostgreSQL on the same host, add the following to the [Unit] section of /lib/systemd/system/origin.service:

After=postgresql.service
BindsTo=postgresql.service

Step 5: Configure the server​

Copy the default configuration to the active config file with the right ownership and permissions:

sudo install -C -m 600 -o origin -g origin \
/opt/origin/config/config.defaults.json \
/opt/origin/config/config.json

Edit /opt/origin/config/config.json and set:

  • SqlSettings.DriverName: "postgres"
  • SqlSettings.DataSource: "postgres://mmuser:<mmuser-password>@<host>:5432/origin?sslmode=disable&connect_timeout=10" — replace each placeholder.
  • ServiceSettings.SiteURL: the public URL of your deployment (e.g., https://origin.example.com).
  • (Recommended) SupportSettings.SupportEmail: the email address users contact for help.
TLS mode for DataSource

The sslmode value depends on your database environment. The two relevant options are disable and require. Managed services such as AWS Lightsail require sslmode=require. Check your provider's documentation.

Start the server:

sudo systemctl start origin

Verify it's running:

curl http://localhost:8065

You should see the Origin by Corvus HTML response. Enable the service on boot:

sudo systemctl enable origin.service

Step 6: Update Origin by Corvus​

When a new release is published, update through APT:

sudo systemctl stop origin
sudo apt update && sudo apt upgrade
sudo systemctl start origin
Stop the server before upgrading

apt upgrade will replace the Origin by Corvus binary while it's running. Stop the systemd service first to avoid corrupt state.

Remove Origin by Corvus​

sudo systemctl stop origin
sudo apt remove --purge origin

This removes the package but leaves /opt/origin/data, /opt/origin/logs, /opt/origin/plugins, and /opt/origin/config in place. Back these up before deleting if you may need to restore.

Next steps​