Skip to main content

Deploy Origin by Corvus on Red Hat Enterprise Linux

Install Origin by Corvus Server on Red Hat Enterprise Linux (RHEL) 9+ or a compatible distribution, such as Rocky Linux, AlmaLinux, Oracle Linux, or CentOS Stream 9+. RHEL doesn't have a signed APT-style repository, so this guide installs from the release tarball with manual systemd setup, then walks through the security configuration RHEL deployments typically need (SELinux contexts, firewalld rules, fapolicyd allow rules).

Step 1: Get a PostgreSQL database​

Choose one of:

  • Install PostgreSQL locally on the same host. See the PostgreSQL installation documentation.
  • Use an external PostgreSQL server and collect connection credentials before 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: Download the Origin by Corvus Server tarball​

SSH onto the target host and download the release. Replace amd64 with arm64 for ARM-based hardware.

wget https://releases.origin.com/12.0.1/origin-12.0.1-linux-amd64.tar.gz

Step 4: Install Origin by Corvus Server​

Update existing system packages first:

sudo dnf update
sudo dnf upgrade

Extract the tarball, move it into place, and set ownership:

tar -xvzf origin*.gz
sudo mv origin /opt
sudo mkdir /opt/origin/data
sudo useradd --system --user-group origin
sudo chown -R origin:origin /opt/origin
sudo chmod -R g+w /opt/origin

Create the systemd unit file at /etc/systemd/system/origin.service:

[Unit]
Description=Origin by Corvus
After=network.target

[Service]
Type=notify
ExecStart=/opt/origin/bin/origin
TimeoutStartSec=3600
KillMode=mixed
Restart=always
RestartSec=10
WorkingDirectory=/opt/origin
User=origin
Group=origin
LimitNOFILE=49152

[Install]
WantedBy=multi-user.target

Reload systemd:

sudo systemctl daemon-reload

Step 5: Configure and start the server​

Back up the default config before editing:

sudo cp /opt/origin/config/config.json /opt/origin/config/config.defaults.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.

Start the server:

sudo systemctl start origin
curl http://localhost:8065

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

sudo systemctl enable origin.service

If start fails on a hardened RHEL system, continue to the Hardened RHEL configuration section below before troubleshooting elsewhere — it's almost always SELinux, firewalld, or fapolicyd.

Step 6: Update the server​

Tarball-based installs are upgraded manually. See Upgrading Origin by Corvus Server.

Hardened RHEL configuration​

Hardened RHEL installs typically require additional configuration for SELinux, firewalld, and fapolicyd. Each is covered below.

RHEL 9 ships with SELinux in enforcing mode. Verify with sestatus. If it's enforcing, set the appropriate contexts before starting Origin by Corvus.

Set the binary context for /opt/origin/bin:

sudo semanage fcontext -a -t bin_t "/opt/origin/bin(/.*)?"
sudo restorecon -RF /opt/origin/bin

Set the directory context for /opt/origin. Check current context:

ls -Z /opt/origin

If the type is default_t, set a web-application context:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/origin(/.*)?"
sudo restorecon -R /opt/origin

Allow Origin by Corvus to bind to port 8065 (or your configured port):

sudo semanage port -l | grep 8065
sudo semanage port -a -t http_port_t -p tcp 8065

Generate a custom policy if SELinux blocks something specific. Check denials:

sudo ausearch -m avc -ts recent
sudo cat /var/log/audit/audit.log | grep denied

Generate a policy module from those denials:

sudo yum install -y policycoreutils-python-utils
sudo grep origin /var/log/audit/audit.log | audit2allow -M origin_policy
sudo semodule -i origin_policy.pp

Restart and verify:

sudo systemctl restart origin

References

Remove Origin by Corvus​

Stop the server, back up any data you need, then remove the install directory:

sudo systemctl stop origin
sudo rm -rf /opt/origin
sudo rm /lib/systemd/system/origin.service
sudo userdel origin

Next steps​