User Tools

Site Tools


packet:xrouter-service

XRouter running as a systemd service

As XRouter is distributed as a loose binary, a little work is needed to get it set up as a service.

  • Set up a dedicated user to run as (“xr” in this example)
  • Copy the XRouter binary for your platform (probably xrpi64 or xrlin64) to the home directory
  • Run as the user for initial setup.
  • Create a service specification, using the below as a guide.
  • Profit.

Sample systemd service

[Unit]
StartLimitIntervalSec=5
Description=XRpi service
After=network.target
StartLimitIntervalSec=0
[Service]
Type=forking
Restart=always
RestartSec=5
User=xr
WorkingDirectory=/home/xr
ExecStart=/home/xr/xrpi64 -d

[Install]
WantedBy=multi-user.target

Network Access to XRouter from other subnets

XRouter uses a file called ACCESS.SYS in it's working directory to determine what rules are in place for accessing the instance - if it is present.

If you need to access the instance from another network, you will need to create the file and enter the network addresses and CIDR masks that you wish to permit.

e.g.

192.200.0.0/24 1

Syntax is as follows:

<subnet>[/bits] <access_flags>

The <access_flags> parameter is the sum of these flag values.

  • 1 - Valid callsigns only
  • 2 - Password required
  • 4 - Guest access allowed

More information on ACCESS.SYS config can be found on the Ohio Packet documentation pages.

Working example:

# cat /etc/systemd/system/xrouter.service
[Unit]
StartLimitIntervalSec=5
Description=XRpi service
After=network.target
StartLimitIntervalSec=0

[Service]
Type=forking
Restart=always
RestartSec=5
User=xr
WorkingDirectory=/home/xr
ExecStart=/home/xr/xrlin64 -d

[Install]
WantedBy=multi-user.target
packet/xrouter-service.txt · Last modified: 2025/01/26 18:01 by m0lte