GoAdmio

skeleton

Create the skeleton FTP account, or reset it with a new password, and make the /var/skeleton template folder writable

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


Overview

/go/skeleton sets up the skeleton FTP account, the login for the template files that new accounts can start from. When you create an account with create and --skeleton y, GoAdmio copies the files in /var/skeleton/ into the new site.

Each run:

Use it to create the account the first time, or to reset its password later. The same command does both.


Quick start

# Create or reset the skeleton FTP account
/go/skeleton 'YourStrongPassword'

Syntax

/go/skeleton <password>

The command writes the call and a timestamp to /var/log/go/skeleton.log. The password is written to that log too. See Security. Run the command as root.


Arguments

Argument Required Notes
<password> Yes The new password for the skeleton FTP user. It is not checked or validated.

Always pass a password. The command does not stop when it is missing, and what happens then depends on the operating system.

Quote the password in single quotes to protect symbols from your shell. On Debian and Ubuntu the script passes the password on without quotes, so a password with spaces or characters such as *, $, or ; can be split or changed. Use letters and numbers only on those systems.


Output

The command prints the output of the system tools it runs, then a confirmation:

Skeleton FTP password has been changed successfully.

This line is printed every time, even if a step failed. Most error messages are hidden. Confirm the result by logging in over FTP as skeleton.

Unknown operating system

Unknown operating system.

Nothing is changed. This appears when the OS name in /usr/local/goadmio/linux/os.db is not AlmaLinux, Rocky, CentOS, Red Hat, Fedora, Debian, or Ubuntu.


Examples

# Create or reset the account
/go/skeleton 'N3wStr0ngPass'
# Type the password without it appearing on screen or in shell history
read -rs -p "Password: " P; echo
/go/skeleton "$P"
unset P
# Review recent calls (this log contains the passwords)
tail /var/log/go/skeleton.log

Troubleshooting

Symptom Likely cause Fix
Unknown operating system. The OS name is not one of the supported ones. Create the account by hand.
passwd: Only root can specify a user name The command was not run as root. Run it as root.
Password doesn't work on Debian or Ubuntu, and it contains symbols or spaces The password is passed on without quotes. Use a password of letters and numbers only.
"changed successfully" shown, but FTP login fails The message is always printed. A step may have failed silently. Run the command again as root, then test the login.
Active FTP transfers were interrupted vsftpd is restarted on every run. Run it when no transfers are in progress.
The password appears in /var/log/go/skeleton.log The script logs every argument. Delete the log entry, and see Security.

Details

What it does

  1. Records the call, including the password, in the log.
  2. Reads the OS name.
  3. Removes the skeleton group and user, ignoring errors.
  4. Creates the skeleton user again and sets its password:
    • AlmaLinux, Rocky, CentOS, Red Hat, Fedora: adduser skeleton, then passwd skeleton --stdin
    • Debian, Ubuntu: GoAdmio's adduser script
  5. If /var/skeleton exists, adds write permission for everyone (chmod a+w).
  6. Prints the confirmation line.
  7. Restarts vsftpd.
flowchart TD
    A["skeleton password"] --> B["Log the call"]
    B --> C{"Supported OS?"}
    C -- "No" --> X["Unknown operating system, stop"]
    C -- "Yes" --> D["Remove the old skeleton user"]
    D --> E["Create the user with the new password"]
    E --> F{"/var/skeleton exists?"}
    F -- "Yes" --> G["Make /var/skeleton writable"]
    F -- "No" --> H["Print confirmation"]
    G --> H
    H --> I["Restart vsftpd"]

What is and isn't changed

Item Result
skeleton user and group Deleted, then created again.
The old user's files Kept. The user is removed without deleting its home folder.
/var/skeleton Made writable for everyone. Only the folder itself is changed, not the files in it.
Accounts created earlier with --skeleton y Not affected. They already hold their own copy.
FTP server Restarted.

Security


See also

Command Description
create Create a GoAdmio account (--skeleton y copies the template files)
ftp Create or edit FTP accounts for a domain
vsftpd Install and configure the VSFTPD FTP server
password Change a GoAdmio account's FTP, SSH, and panel login password
adduser Create the system/FTP user for the account (used internally)
permission Enable or disable FTP permissions for a domain