mk6i-open-oscar-server/docs/SYSTEMD.md

Configuring Open OSCAR Server With systemd

This document details the configuration of Open OSCAR Server to run as an unprivileged user with systemd managing it as a production service.

1. Download Open OSCAR Server

Grab the latest Linux release from the releases page

1. Create the ras user and group

Run the following commands:

   sudo useradd ras
   sudo mkdir -p /opt/ras

1. Extract the archive

Extract the archive using the usual tar invocation, and move open_oscar_server into /opt/ras

1. Set Ownership and Permissions

   sudo chown -R ras:ras /opt/ras
   sudo chmod -R o-rx /opt/ras
   

2. Copy the systemd service

Place the ras.service file in /etc/systemd/system

1. Reload systemd

   sudo systemctl daemon-reload
   

2. Enable and start the service

   sudo systemctl enable --now ras.service
   

3. Make sure the service is running

   sudo systemctl status ras.service
   sudo journalctl -xeu ras.service
   

Note that the systemd service defines the configuration for Open OSCAR Server directly, bypassing the settings.env config. Customizations may be performed in /etc/systemd/system/ras.service.