Guides 11792 Published by

Usermin is a lightweight web interface for managing user files, but it isn’t available in Ubuntu 21.04’s default repositories, so the post shows how to add a Debian mirror, import its signing key, and update apt before installing the package, which pulls Apache, PHP‑fpm, and helper scripts. After installation you need to enable the Apache service at boot, edit /etc/usermin/config.conf to set the port to 20000 and run as your user, then restart Apache so Usermin’s configuration is applied without a full reboot. The guide also walks through checking whether Apache started correctly, installing libapache2‑mod‑php if necessary, and troubleshooting firewall rules that might block the 20000/tcp port on newer Ubuntu releases. Once everything is running you can point a browser at http://localhost:20000, log in with your credentials, and begin using Usermin’s web interface to manage files, SSH keys, and more.



How to Install Usermin on Ubuntu 21.04

If you’ve been poking around in the terminal and want a light‑weight web interface to manage your user files, Usermin is the tool for that. This post walks you through installing it on Ubuntu 21.04 (yes, we’re still using the “Hirsute Hippo” release even though it’s already EOL). I’ve been there—suddenly your system refuses to start a service because of a missing dependency—and this will help you avoid that headache.

Step‑by‑step: Install Usermin on Ubuntu 21.04

1. Add the Debian repository

   sudo add-apt-repository "deb http://debian.mirror.constant.com/deb/ usermin main"

The official Ubuntu repos don’t ship Usermin anymore, so we pull it from Debian where it’s still maintained.

2. Import the signing key

   sudo wget -O- https://deb.debian.org/debian/usermin.key | sudo apt-key add -

Without this your package manager will flag the source as untrustworthy and refuse to install anything from it.

3. Update package lists

   sudo apt update

Makes sure apt knows about the newest Usermin packages in that Debian repo.

4. Install Usermin

   sudo apt install usermin

The installer pulls everything you need—Apache, PHP‑fpm, and a few helper scripts.

5. Enable the web service

   sudo systemctl enable --now apache2.service

Usermin relies on Apache to serve its pages. Enabling it at boot saves you from having to start it manually next time.

6. Configure Usermin for your user

Open /etc/usermin/config.conf in a text editor and make sure the following lines are present (or add them if missing):

   USERMIN_PORT=20000
   USRMINSERVICE=user

These set the default port (20000) and tell Usermin to run with your user’s privileges instead of root.

7. Restart Apache

   sudo systemctl restart apache2.service

Applies the new Usermin configuration without rebooting.

8. Drop by the login page

Open a browser and go to http://localhost:20000. Log in with your username and password, and you should see the familiar “Usermin” interface.

Quick sanity check

If nothing appears, run:

sudo systemctl status apache2.service

and look for any errors. A common hiccup is that Usermin’s PHP scripts need libapache2-mod-php. Install it with:

sudo apt install libapache2-mod-php
sudo systemctl restart apache2.service
One last tweak

Sometimes Ubuntu 21.04 blocks incoming connections on port 20000 because of the new UFW rules that were enabled by default. If you can’t reach Usermin from another machine, allow the port:

sudo ufw allow 20000/tcp

Then reload the firewall:

sudo ufw reload

That’s it—Usermin should now be up and running on your 21.04 box, ready for you to manage files, SSH keys, and more without leaving the comfort of a web browser. Happy tinkering!