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.
- 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
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.
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.
DataSourceThe 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
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.