GoAdmio

package

Upgrade system packages, then install any missing GoAdmio base packages and tools

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


Overview

/go/package prepares a server for GoAdmio by installing the system packages and tools that GoAdmio's other commands rely on. It:

It supports AlmaLinux, Rocky Linux, CentOS, Red Hat, Fedora, Debian, and Ubuntu. The command runs sudo internally, so run it as root or as a user with sudo rights, and the server needs internet access.

[!WARNING] Every run upgrades all installed packages on the system, not only the ones GoAdmio needs. On Debian and Ubuntu it also runs apt autoremove, which removes packages the system considers unused.


Quick start

# Install all missing base packages
/go/package

Syntax

/go/package

The command takes no arguments. Anything you add is written to the command log but otherwise ignored.

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


Options

None.


Output

The command prints a progress message for each step, such as Installing Screen, followed by the package manager's own output. It prints no final summary.

Outcome What you get
Supported operating system Progress messages for each missing package, then the shc and WebP steps if they are missing.
Everything already installed The upgrade or update output only.
Unsupported operating system No package steps run. Only the shc and WebP checks at the end still run.

The command does not stop when a step fails, and it has no exit status of its own: the status is that of the last command it ran. Read the output for errors.

Log

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

[Nov 21 12:00:00]# package

Examples

# Install all missing base packages
/go/package
# Run inside screen so a lost SSH connection doesn't interrupt it
screen -S package /go/package
# See recent runs
tail /var/log/go/package.log
# Check that a tool is installed
command -v ttyd

Troubleshooting

Symptom Likely cause Fix
A package fails with "no match" or "not found" on the RHEL family Some packages (for example s3fs-fuse, restic, sshpass, swaks, and dropbear) typically come from the EPEL repository, not the base repositories. Enable EPEL, then run the command again. Only the missing packages are installed.
A download step fails (rclone, ttyd, rar, borg, shfmt, wkhtmltox) The server can't reach rclone.org, github.com, or rarlab.com. Check DNS, the firewall, and outbound access, then run again.
The command takes a long time The system upgrade runs first and can be large. Run it inside screen so it continues if your connection drops.
Packages were removed or upgraded unexpectedly The system upgrade and apt autoremove run on every run. See the warning in Overview.
vi opens nano nano was missing, so the command copied it over vi and edit. None. This is expected.
Installing LIBDBD-MariaDB-PERL appears on every run (Debian and Ubuntu) The check for this package has no package name, so it always counts as missing. None. The install does nothing when the package is already present.
No package steps ran The operating system isn't one of the supported systems. Install the packages manually.

Details

What gets installed

Each package is installed only if it isn't already present. A "—" means the system does not get that package from this command.

Group RHEL family (dnf) Debian and Ubuntu (apt)
Terminal and editors screen, nano, vim screen, nano, vim
Mail s-nail, swaks mailutils, swaks
SSH and remote access openssh-clients, sshpass, dropbear sshpass, dropbear
Scheduling and logging cronie, at, rsyslog cron, at, rsyslog
DNS tools bind, bind-utils, whois bind9, dnsutils, whois
Network tools telnet, net-tools, nmap, nc, NetworkManager telnet, net-tools, nmap, netcat-traditional, network-manager
System tools yum-utils, psmisc, inxi, pv, microcode_ctl, gdisk, quota, geoip psmisc, inxi, pv, gdisk, quota, geoip-bin
Build tools The "Development Tools" group build-essential
Languages and package managers git, npm, python39 (if no python3), python3-pip git, npm
Data tools jq, xmlstarlet, bc, gawk, sqlite, libsodium, libsodium-devel jq, xmlstarlet, bc, gawk, sqlite3, libsodium23, libsodium-dev
Compression zip, unzip, p7zip (as 7z), qpress, rar and unrar (downloaded) zip, unzip, rar, unrar, p7zip-full
Images and PDF ImageMagick, ghostscript imagemagick, ghostscript
Storage and backup restic, s3fs-fuse, cifs-utils, fuse3, rclone (downloaded) restic, s3fs, cifs-utils, fuse3, rclone (downloaded)
Cache server redis, or valkey if redis isn't in the repositories redis
Web terminal ttyd (downloaded from GitHub) ttyd (downloaded from GitHub)

Extra tools

These are installed only when /usr/local/goadmio/db/lite.db does not exist.

Tool RHEL family Debian and Ubuntu
OCR tesseract tesseract-ocr
JPEG optimizer jpegoptim jpegoptim
HTML to PDF wkhtmltox 0.12.6-1 (RPM built for CentOS 8, with compat-openssl11) wkhtmltopdf
Web server monitor apachetop apachetop
Backup borg 1.2.4 (downloaded) borg 1.2.4 (downloaded)
Shell formatter shfmt 3.13.1 (downloaded) shfmt 3.13.1 (downloaded)
FTP client lftp lftp
Perl MariaDB driver — libdbd-mariadb-perl

Other steps

Step Condition Action
FTP server vsftpd isn't installed Runs vsftpd.
Script compiler shc isn't found Runs /go/shc.
WebP support cwebp isn't found Runs installwebp.

The last two steps run on every operating system, including unsupported ones.

Services and system changes

Change Detail
Services enabled and restarted redis or valkey, dropbear, atd, and rsyslog.
Services enabled only named (RHEL family) and bind9 (Debian and Ubuntu).
BIND backup On Debian and Ubuntu, copies /etc/bind/named.conf.options to named.conf.options.bak the first time it installs BIND, if no backup exists.
nano replaces vi If nano is missing, it is installed along with vim, then copied over /bin/edit and /bin/vi. The VISUAL and EDITOR variables are set only for the running script, so they don't persist.
7z On the RHEL family, p7zip is installed and 7za is copied to 7z.
Postfix preset (Ubuntu) Before installing mailutils, the command presets Postfix to "Internet Site" with the server hostname as the mail name, so the install doesn't ask questions.
Package prompts On Debian and Ubuntu, existing configuration files are kept when a package would replace them.
Leftover files Downloaded files such as the RAR archive and ttyd are fetched into /tmp.

The command takes the operating system name from GoAdmio's shared function file (/go/function).

flowchart TD
    A["package"] --> B["Log the run, load shared functions"]
    B --> C{"Operating system"}
    C -- "AlmaLinux / Rocky / CentOS / Red Hat / Fedora" --> D["dnf upgrade, then install missing packages"]
    C -- "Debian / Ubuntu" --> E["apt update and autoremove, then install missing packages"]
    C -- "Other" --> J
    D --> F{"lite.db exists?"}
    E --> F
    F -- "No" --> G["Install the extra tools"]
    F -- "Yes" --> H["Skip the extra tools"]
    G --> I["Install vsftpd if missing"]
    H --> I
    I --> J["Install shc and WebP support if missing"]

See also

Command Description
vsftpd Install and configure the VSFTPD FTP server
installwebp Install WebP support in GoAdmio
dropbear Install Dropbear (a lightweight SSH server) on a custom port, or show the current Dropbear port
installmail Install and configure webmail services (Postfix and Dovecot)
nodejs Install or reinstall Node.js (default version 22), plus npm, Git, and mudslide
installphp Install a PHP version with its extensions and PHP-FPM service on a GoAdmio server