GoAdmio

web

Restart (default) or reload the active web server, Nginx or Apache

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/web restarts or reloads the web server that GoAdmio is running, so you don't need to know whether the server uses Nginx or Apache, or what the service is called on your operating system.

It handles the web server only. To restart PHP-FPM too, use restart or reload.

The command runs sudo internally, so run it as root or as a user with sudo rights.


Quick start

# Restart the web server
/go/web

Syntax

# Restart
/go/web

# Reload
/go/web reload
Form Behavior
/go/web Restarts the web server.
/go/web reload Reloads the web server's configuration without stopping it.

Every run is recorded in /var/log/go/web.log, with the time and the arguments you passed.


Options

Argument Required Default Notes
reload No Restart Reloads instead of restarting. Any argument that contains the word reload counts.

Output

The command prints nothing when it works. If systemctl can't restart or reload the service, you see its error message.

The command does not test the configuration first, and it prints no message of its own. On an unsupported operating system it silently does nothing.

Log

Each run appends one line to /var/log/go/web.log:

[Nov 21 12:00:00]# web reload

Examples

# Restart the web server
/go/web
# Reload the configuration without interrupting visitors
/go/web reload
# See which web server GoAdmio is using
cat /usr/local/goadmio/linux/ws.db
# Check that the web server is running (use httpd or apache2 for Apache)
systemctl status nginx

Troubleshooting

Symptom Likely cause Fix
The websites are down after a restart The web server's configuration has an error, so it couldn't start. Test and repair it with checkapache or checknginx, then run the command again.
Unit ... not found or Failed to restart GoAdmio's record of the active web server doesn't match what is installed. Check /usr/local/goadmio/linux/ws.db. Anything other than NGINX is treated as Apache.
Nothing happens and nothing is printed The operating system isn't one of the supported systems. Restart the service by hand with systemctl.
A change doesn't show up after reload Some changes, such as a new web server version, need a full restart. Run /go/web without reload.
A reload happened when you wanted a restart An argument contained the word reload. Run the command with no arguments.

Details

Which service it controls

GoAdmio records the active web server in /usr/local/goadmio/linux/ws.db. If it contains NGINX, the command controls Nginx. Any other value, including an empty file, means Apache.

Operating system Nginx Apache
AlmaLinux, Rocky, CentOS, Red Hat, Fedora nginx httpd
Debian, Ubuntu nginx apache2

The command runs systemctl restart <service>, or systemctl reload <service> when reload is given.

Restart or reload

Restart Reload
Visitors Connections are cut briefly. Not interrupted.
If the new configuration is invalid The web server may fail to start, and sites stay down. The running web server keeps working with its old configuration.
Use it when You need a clean start. You changed a virtual host, redirect, or other configuration.

Prefer reload when you can: it is safer if the configuration contains an error.


See also

Command Description
restart Restart all PHP-FPM pools and the active web server
reload Reload PHP-FPM and the active web server
fpm Restart all installed PHP-FPM versions on your server
checkapache Test the Apache configuration and remove SSL virtual hosts whose Let's Encrypt certificate is missing, then rebuild it
checknginx Test the Nginx configuration and remove the virtual host of any domain whose Let's Encrypt certificate is missing, then rebuild it
apache Switch the server from Nginx to Apache, or rebuild a domain's Apache virtual host
nginx Convert a GoAdmio server from Apache to Nginx