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 settings.env config. Customizations may be performed in /etc/systemd/system/ras.service.