GoAdmio

password

Change a GoAdmio account's FTP, SSH, and panel login password for one domain or all domains

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


Overview

/go/password sets a new password for a hosting account. One password covers the account's FTP login, SSH login, and GoAdmio panel login. It:

The command re-runs itself with sudo if it isn't started as root.


Quick start

/go/password example.com 'N3wS3cureP4ss'

Syntax

# One account
/go/password <domain> <password>

# Every account on the server
/go/password all [password]
Form Behavior
/go/password <domain> <password> Changes the password for that domain's account.
/go/password all Generates one random 16-character alphanumeric password and applies it to every account.
/go/password all <password> Applies the given password to every account.

[!WARNING] In single-domain mode the command does not generate a password. If you omit <password>, an empty value is passed on. Always supply one.

[!WARNING] With all, every account receives the same password, whether you supply it or the command generates it. Use per-account random passwords if you need unique ones.


Arguments

Argument Required Default Notes
<domain> Yes — The account's primary domain, exactly as stored in GoAdmio, or all. It is not lowercased or normalized.
<password> Single mode: yes. all: no all: random 16 alphanumeric characters Use letters and digits, or at least avoid spaces and the characters *, ?, and $. Internal calls don't quote the value.

The command has no --option flags.


Output

Outcome What you get
Single account changed Password has been modified successfully (<domain>)., then Change default password for all MySQL Databases: followed by the output of phpmyadmin.
/home/<domain> doesn't exist Directory /home/<domain> not exists. and exit code 1.
all The messages above for each account, then a two-column table (Domain Password) of every changed account.
Unsupported operating system No success message and the system user is not changed. See Details.

Notes on the output:

Logging

The command appends a line to /var/log/go/password.log with a timestamp and ******** in place of every argument. The log therefore doesn't record which domain was changed.

Security

[!WARNING] The new password is visible in plain text in the all output table, in the process list while the command runs, and in your shell history. Clear your history after use, or run the command from a script that doesn't log it.

The panel stores a salted hash, md5("<password>|<salt>"), not the password itself. This is the same scheme create uses.


Examples

# Change one account's password
/go/password example.com 'N3wS3cureP4ss'
# Change every account to one generated password
/go/password all
# Change every account to a password you choose
/go/password all 'SharedPass2026'
# Unique random password per account, printed once
for d in $(ls /home); do
  [ -d "/home/$d/www" ] || continue
  p=$(openssl rand -base64 16 | tr -dc 'A-Za-z0-9' | head -c 16)
  /go/password "$d" "$p" >/dev/null && echo "$d $p"
done

Troubleshooting

Symptom Likely cause Fix
Directory /home/<domain> not exists. Wrong domain, or no account for it. Check the domain, or create the account with create.
Every account got the same password after all The first generated or supplied password is reused for every account. Use the per-account loop in Examples.
Script reports failure (exit code 1) after all all always exits with 1. Ignore the exit code and check the printed table.
Password with spaces or special characters is wrong or rejected Internal calls don't quote the password, so it is split. Use letters and digits only.
Account set to an empty password <password> was omitted in single mode. Run again with a password.
FTP or SSH login fails right after the change The ownership fix is still running in the background, or adduser failed. Wait a minute, then run fix for the domain.
Background fix never runs screen isn't installed. Install screen, then run fix manually.
Panel login still accepts the old password The command stopped before the final database update. Run the command again.
MySQL database passwords didn't change The new password isn't passed to phpmyadmin. Change database passwords with the database commands.
Nothing changed on a custom or minimal OS The OS is not in the supported list. See Details.

Details

What it does

  1. Re-runs itself with sudo if not root.
  2. Logs the call to /var/log/go/password.log with arguments hidden.
  3. Reads the operating system name from /usr/local/goadmio/linux/os.db.
  4. In all mode, loops over every folder in /home that has a www directory, generates a password the first time if none was given, and runs /go/password <domain> <password> for each. Then prints the table and exits.
  5. Looks up the username in /var/lib/sqlite/site.db (Site table).
  6. Exits if /home/<domain> doesn't exist.
  7. On AlmaLinux, Rocky, CentOS, Red Hat, Fedora, Debian, or Ubuntu: deletes the user and group (groupdel, userdel -f), then recreates the user with adduser and the new password, and prints the success message.
  8. Starts /go/fix <domain> in a detached screen session.
  9. Runs passwd to refresh the account's jailed-shell user and group files.
  10. Restarts vsftpd.
  11. Generates a random salt, hashes <password>|<salt>, and updates the Password and Salt columns of the account's Site row.
  12. Runs phpmyadmin for the domain.
flowchart TD
    A["password domain password"] --> B{"domain = all?"}
    B -- "Yes" --> C["For each account with a www folder: run password with the same password"]
    C --> D["Print table, exit 1"]
    B -- "No" --> E{"/home/domain exists?"}
    E -- "No" --> F["Error message, exit 1"]
    E -- "Yes" --> G["Delete and recreate system user"]
    G --> H["Background: fix"]
    H --> I["passwd, restart vsftpd"]
    I --> J["Update panel password hash"]
    J --> K["Run phpmyadmin for the domain"]

Unsupported operating systems

If the operating system is not one of the seven listed in step 7, the system user is not changed and no success message prints. Steps 8 to 12 still run, so the panel hash is updated and no longer matches the FTP and SSH password.

Notes for maintainers

Issue Why it matters Suggested fix
all reuses the first password Every account ends up with the same password. Generate a new password inside the loop when none was supplied.
Single mode has no password generation or check An empty password can be set. Generate a random one, or exit when $2 is empty.
all exits with 1 on success Callers treat success as failure. Use exit 0.
Table header says Domain but prints the username Misleading output. Print $Domain, or rename the header.
User is deleted and recreated with userdel -f Can change UID/GID, break running sessions and processes, and depends on the background fix. Change the password in place with echo "$Username:$Password" | chpasswd.
Two identical OS branches Duplicated code, and unsupported systems are silently skipped. Merge the branches and add an else that reports the problem.
Unquoted $Username, $Password, $Domain Spaces and glob characters break arguments. Quote every variable.
Domain is placed directly in SQL queries Quotes in the value break the query and can be abused. Validate the domain against ^[a-z0-9.-]+$.
No check that $Username is non-empty A folder with a www directory but no Site row runs userdel and adduser with an empty name. Skip the account when the username is empty.
Password passed on the command line and logged as ******** for every argument Visible in ps, and the log hides the domain. Read the password from stdin or an environment variable; log $1 and mask only $2.
Success message prints before later steps A later failure still looks like success. Print it at the end.
MySQLRootPassword is read but never used Loads a root credential for no reason. Remove the line.
Salted MD5 for the panel password MD5 is too fast to resist offline cracking. Use bcrypt or Argon2, which needs a matching change in the panel login code.

See also

Command Description
passwd Refresh an account's user and group entries in its site etc folder
adduser Create the system/FTP user for the account (used internally)
fix Fix GoAdmio file and folder permissions
phpmyadmin Install the latest phpMyAdmin on a GoAdmio server
create Create a GoAdmio account from the command line
username Change the GoAdmio account username