GoAdmio

support

Interactive menu that runs the usual repair commands for common GoAdmio problems (web server, control panel, webmail, SSL, permissions)

[!NOTE] The index describes this command as an "AI support solution". The script documented here has no AI. It is a fixed menu: each option runs a set of other GoAdmio commands. Either update the index description to match this page, or check that this is the script you meant to document.

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


Overview

/go/support is a self-service helper for administrators. It shows a list of common problems. You pick one, and the command runs the commands that usually fix it. At the start it says that, if the problem remains, you can contact support@goadmio.com.

Some options only restart or rebuild a configuration. Others change the whole server, for example by switching the web server or reinstalling PHP. Read Options before choosing.


Quick start

# Show the menu and type an option
/go/support

# Run option 14 (fix permissions) without the menu
/go/support 14

Syntax

/go/support
/go/support <option>
Form Behavior
/go/support Prints the menu, then waits for you to type an answer.
/go/support <option> Skips the question and runs the option. Only the first argument is used.

The prompt says you can ask a short question, but the command doesn't understand questions. It accepts only the option numbers and these keywords:

Keyword Same as
nginx, apache, httpd Option 1
reinstallnginx, reinstallapache, reinstallhttpd Option 2

Anything else gives no reply at all.

[!WARNING] Keywords are made lowercase only when you pass them as an argument. In the interactive prompt, NGINX or Apache in capitals does nothing.


Options

Options 1 and 2 name Nginx or Apache, depending on the web server of this server.

Option Menu text What it runs
1 I can't restart NGINX/Apache. conf, to rebuild the web server configuration
2 I can't reinstall NGINX/Apache. Reads the control panel's status page. If it doesn't say 1, runs conf. Otherwise prints that the web server is already installed and running. It never reinstalls the packages.
3 I can't access the control panel. Reads the status page. If the panel answers: runs session and prints the panel address http://<server-ip>:2020. If not: runs session, installphp with 8.2, and conf.
4 I can't update control panel. Downloads an installer from https://download.goadmio.com into the current folder as latest, runs latest update, then runs update.
5 (Not shown in the menu) Does nothing but print Please try now.
6 Roundcube webmail not sending emails. checkmail, roundcube, installmail
7 Rainloop webmail not sending emails. checkmail, snappymail, installmail
8 Horde webmail not sending emails. checkmail, installmail
9 I can't set time, date & time zone. timezone
10 I can't install an SSL certificate on my domain. conf
11 I can't renew SSL certificate for my domain. checkssl
12 I deleted "/usr/local/goadmio" folder by mistake. update
13 I deleted "goadmio" database by mistake. restore database (see restore)
14 I can't fix files and folders permissions. fix, for every account
15 I can't switch from Apache to Nginx. nginx, which converts the whole server
16 I can't switch from Nginx to Apache. apache, which converts the whole server
17 I can't install XRDP. xrdp

Options with a larger effect:


Output

Outcome What you get
Start The greeting, the contact address support@goadmio.com, and the menu.
An option ran The output of its commands, then Please try now. (options 9 and 13 don't print it).
Unknown answer Nothing.

The exit code is 0 in most cases.

Logging

Every run is appended to /var/log/go/support.log.


Examples

# Interactive menu
/go/support
# Fix permissions for all accounts
/go/support 14
# Rebuild the web server configuration
/go/support apache
# Set the time zone
/go/support 9

Troubleshooting

Symptom Likely cause Fix
Nothing happens after I type a question The command only accepts option numbers and a few keywords. Type a number from the menu, or contact support@goadmio.com.
NGINX in capitals does nothing The interactive answer is not made lowercase. Type nginx, or pass the keyword as an argument.
Option 2 says the web server "is already installed and running" and didn't reinstall The option only checks the control panel's status page. Use the individual commands to reinstall the packages.
Option 2 or 3 rebuilds the configuration although the panel works The status check goes to the server's public address on port 2020, and a firewall or NAT can block that. Test http://<server-ip>:2020 from outside.
PHP 8.2 was reinstalled Option 3 runs installphp 8.2 when the panel doesn't answer. See installphp and the notes on Debian and Ubuntu.
A file named latest is in the current folder Option 4 saves its installer there. Delete it.
The web server changed Options 15 and 16 convert the whole server. Run the opposite option to go back.
Option 12 prints errors about missing files before it runs The script reads files from the deleted folder at its start. Expected. The update still runs.
Option 7 says Rainloop but installs something else It installs SnappyMail. Expected.
Nothing happens when run without a terminal The question can't be read. Pass the option as an argument.

Details

What it does

  1. Logs the call, and reads the operating system and the web server (Nginx or Apache) from /usr/local/goadmio/linux/.
  2. Prints the greeting, the contact address, and the menu.
  3. Takes the answer from the first argument (made lowercase), or asks for it.
  4. Runs the commands for the matching option from Options, and prints Please try now.
flowchart TD
    A["support"] --> B["Print menu"]
    B --> C{"Argument given?"}
    C -- "No" --> D["Ask for an answer"]
    C -- "Yes" --> E["Use the argument, in lowercase"]
    D --> F["Run the commands of the option"]
    E --> F
    F --> G["Please try now."]

Notes for maintainers

Issue Why it matters Suggested fix
The index says "AI" but the script is a fixed menu Users expect free-text help. Change the description, or add real question handling.
Only six keywords exist, and an unknown answer gets no reply The prompt invites questions, and then does nothing. Print "not understood" with the contact address.
The interactive answer is not made lowercase Keywords in capitals fail, unlike the argument form. Lowercase both.
Option 2 is "reinstall" but never reinstalls Misleading. Rename it, or do the reinstall.
Options 1 and 10 both run conf, and option 10 never runs ssl SSL installation problems aren't addressed. Option 11 only checks. Run ssl for option 10, and renew in option 11.
Option 4 downloads and runs a program in the current folder with no verification A changed download is run, and the latest file stays behind. chmod and ./latest run without sudo. Use a temporary folder, verify a checksum, and delete the file.
Option 3 installs PHP 8.2 as a side effect On Debian and Ubuntu it purges and reinstalls that version. Find the real cause first: the service, the port, or the firewall.
Options 15 and 16 convert the whole server with no confirmation and no check of the current server Downtime and a repeated conversion by mistake. Ask for confirmation, and compare with the current web server.
The "Is the panel up" test uses the public address from checkip.amazonaws.com Depends on an outside service, and a firewall or NAT gives wrong results. Test 127.0.0.1:2020 or the service itself.
Option 12 reads missing files at the start Errors for os.db and config.php, and WS is empty. Handle missing files.
Option 5 does nothing and isn't in the menu, option 8 (Horde) has no Horde step, and option 7 is labelled Rainloop Menu and code disagree. Align them.
MySQLRootPassword is loaded but never used A secret is read for no reason. Remove it.
Many separate if blocks and no root check Hard to extend. Use case, and re-run through sudo at the top.

See also

Command Description
help AI solution for auto-detecting and solving GoAdmio server problems
heal Check GoAdmio service status and fix issues
troubleshoot Troubleshoot email problems in GoAdmio
conf Rebuild the Apache/Nginx configuration in GoAdmio
fix Fix GoAdmio file and folder permissions
update Update GoAdmio to the latest version via the command line
checkssl Check if SSL certificates are installed for all domains
nginx Convert a GoAdmio server from Apache to Nginx
apache Convert a GoAdmio server from Nginx to Apache