Admin

Service Management

Start, stop, and restart system services from the Opterius Panel.

Last updated 1775606400

Server Mode → Services lists every service managed by Opterius, their current state, and controls to start, stop, restart, or reload them. Actions are sent to the Agent's /services/action endpoint and executed on the server immediately.

Managed Services

Service Role
nginx Web server — serves all hosted sites
php8.1-fpm PHP 8.1 process manager
php8.2-fpm PHP 8.2 process manager
php8.3-fpm PHP 8.3 process manager
php8.4-fpm PHP 8.4 process manager
mariadb Database server
postfix Outbound and inbound mail (SMTP)
dovecot IMAP/POP3 mail retrieval
opendkim DKIM signing for outbound mail
rspamd Spam filtering
powerdns Authoritative DNS server
opterius-agent The Panel ↔ server communication layer
opterius-queue Background job queue (backups, SSL renewals, etc.)

Available Actions

Not all actions are available for every service. The UI only shows valid actions per service type.

  • Start — start a stopped service.
  • Stop — stop a running service.
  • Restart — stop then start. Use this after configuration changes that do not support reload.
  • Reload — send SIGHUP to reload configuration without dropping connections. Available for nginx, postfix, and opendkim.

The Panel shows the result of each action (success or error output from systemd) in a status toast.

Cautions

Warning: Stopping nginx takes down every hosted website on the server immediately. Use Reload instead of Restart whenever possible — nginx reload is zero-downtime.

Warning: Restarting MariaDB while active queries are running can cause those queries to error or return incomplete results. If possible, do this during a low-traffic window or after confirming no long-running transactions are active (SHOW PROCESSLIST; via SSH).

Warning: Stopping opterius-agent disconnects this server from the Panel. You will not be able to perform any Panel operations on this server until the agent is restarted. If you accidentally stop it, restart it via SSH:

systemctl start opterius-agent

Note: Stopping opterius-queue pauses background jobs — SSL certificate renewals, scheduled backups, and similar tasks will not run. Active jobs in progress are not interrupted, but no new jobs will be picked up until the queue is restarted.

Checking Status via SSH

If the Panel cannot reach the agent, you can check service states directly:

systemctl status nginx
systemctl status mariadb
systemctl status opterius-agent

To list all Opterius-relevant services at once:

systemctl status nginx php8.1-fpm php8.2-fpm php8.3-fpm php8.4-fpm \
  mariadb postfix dovecot opendkim rspamd powerdns \
  opterius-agent opterius-queue

Related