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!