GoAdmio

help

Run a standard repair: recreate GoAdmio's config.php, set a new password for GoAdmio's SSH account, rebuild the web server and PHP-FPM configuration for all accounts, and rebuild the mail maps

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


Overview

When something on the server is wrong and you don't know which part, /go/help is a quick general repair. It runs four GoAdmio commands, one after the other, that rebuild the pieces GoAdmio depends on most:

Step Command What it repairs
1 config --force GoAdmio's config.php, which holds the database and SSH login settings
2 connect GoAdmio's root-level SSH account, which gets a new random password
3 conf Apache or Nginx virtual hosts, PHP-FPM pools, and SSL for all accounts
4 vmail The Postfix and Dovecot mail maps

It is a fixed set of steps. It does not look for the problem first, and it does not use AI. If you want a targeted check, see heal and support.

[!NOTE] Type the full path, /go/help. If you type only help, the shell runs its own built-in help command instead.

[!WARNING] Each run sets a new random password for GoAdmio's SSH account, and rebuilds the web configuration of every account. Run it when the server is not busy.


Quick start

/go/help

Syntax

/go/help

The command takes no arguments. Anything you type after it is ignored, and is only written to /var/log/go/help.log with a timestamp.


Output

help prints nothing of its own, and it gives no final message. You will see only what the four commands print. A failure in one step does not stop the next one.


Examples

# Run the standard repair
/go/help
# Review recent calls
tail /var/log/go/help.log
# Each step also records its own call
tail /var/log/go/config.log /var/log/go/connect.log /var/log/go/conf.log /var/log/go/vmail.log

Troubleshooting

Symptom Likely cause Fix
It takes a long time conf rebuilds every account. The time grows with the number of sites. Wait for it to finish.
Sites are slow or unavailable for a short time The web server and PHP-FPM are reloaded while the configuration is rebuilt. Run it at a quiet time.
A tool that logs in to GoAdmio's SSH account stopped working connect set a new password. Update the tool with the new password, which is saved in config.php.
The problem is still there afterwards The cause is outside these four steps. See What it does not cover.
One step failed and you don't know which There is no message for a failed step. Run the four commands one at a time to see their output.

Details

What it does

  1. Records the call in /var/log/go/help.log.
  2. Runs /go/config --force.
  3. Runs /go/connect.
  4. Runs /go/conf.
  5. Runs /go/vmail.
flowchart TD
    A["help"] --> B["config --force"]
    B --> C["connect"]
    C --> D["conf"]
    D --> E["vmail"]

The order matters. config writes the settings file first, and connect then sets the SSH password that goes with it.

What it does not cover

Problem Try
A service is stopped, memory or disk is full heal
The firewall is missing ports checkfirewall
A missing or expiring SSL certificate checkssl
Outgoing mail or the mail certificates checkmail, checkimap, checksmtp
An account's system user is missing checkid
Apache or Nginx fails its configuration test checkapache, checknginx
A broken php.ini checkphpini
DNS or Cloudflare records dns, cloudflare
SSH configuration ssh

See also

Command Description
support AI support solution for GoAdmio server problems
heal Monitor key services, memory, load, and disk, and automatically fix problems
config Create GoAdmio's config.php
connect Create GoAdmio's root-level SSH account and set a new random password
conf Rebuild Apache/Nginx virtual hosts, PHP-FPM pools, and SSL for all accounts
vmail Rebuild the Postfix/Dovecot vmail maps
troubleshoot Troubleshoot email problems in GoAdmio