package
Upgrade system packages, then install any missing GoAdmio base packages and tools
- Command:
/go/package - Category: Installation
- Required option: None
- Output: Progress messages and package manager output; also logged to
/var/log/go/package.log - Last updated: 2026-11-21
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:
- upgrades the system's packages first (
dnf upgradeon the RHEL family,apt updateandapt autoremoveon Debian and Ubuntu) - installs only what is missing, so running it again is safe
- starts and enables the background services some packages bring (such as Redis, Dropbear,
at, and rsyslog) - installs extra tools, unless the server has the file
/usr/local/goadmio/db/lite.db - installs vsftpd,
shc, and WebP support if they are missing
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 |
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 |