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

Configuring Retro AIM Server With systemd

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

1. ** Download Retro AIM 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
   $ sudo mkdir -p /var/ras

1. ** Extract the archive **

Extract the archive using the usual tar invocation, and move the extracted contents 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 Retro AIM Server directly, bypassing the usual run.sh script and settings.env. Customizations may be performed in /etc/systemd/system/ras.service.