Server Setup

Self-host the Ferqon Server using the ferqon CLI. This page covers the production install, configuration, and maintenance on Linux or Windows.

Last updated: August 15, 2026

Ferqon server setup

Ferqon runs as a Python server. You can start it interactively for local development or run it as a systemd service on Linux or a Windows Service on Windows for a shared lab environment.

Interactive server (development)

The fastest way to start the server is from the CLI.

ferqon server start

The server runs on http://localhost:8000 and serves the web frontend at https://revyrlabs.com. Use Ctrl-C to stop it.

Check the server status from another terminal:

ferqon server status

Tail the server logs:

ferqon server logs

Stop the server:

ferqon server stop

Running as a service

For a shared test bench, run the server as a service. On Linux use the systemd user service; on Windows use a service wrapper such as WinSW or NSSM.

systemctl --user enable ferqon-server
systemctl --user start ferqon-server

winsw install ferqon-server.xml
winsw start ferqon-server.xml

Check that it is running:

ferqon server status

Production checklist

Upgrading the server

Check for updates:

ferqon updates check

Upgrade the CLI and server packages. On Linux use the package manager; on Windows download and re-run the installer:

ferqon updates upgrade

.\install_windows.ps1

Restart the server after the upgrade:

ferqon server restart

Troubleshooting