Come hang with us on Discord and chat directly with the team!Discordtop-bar-close-icon

2026-04-09

How to Install UrBackup on NixOS: Complete Server Setup and Configuration Guide

tutorial
img

Introduction

UrBackup is a reliable open-source backup solution designed to protect servers, workstations, and important business data through file and image backups. If you are running NixOS and want a practical way to deploy a backup server, UrBackup is a strong choice thanks to its web-based management interface and flexible configuration options. This guide explains how to install UrBackup on NixOS, adjust the basic server settings, start the service, and confirm that the backup platform is working correctly.

Prerequisites

Before you install UrBackup on NixOS, make sure your environment is ready.

  • A functioning NixOS system
  • A user account with administrative or sudo privileges
  • Network access to download packages and reach the UrBackup web interface

Install UrBackup on NixOS

The first step is to refresh your Nix channels and install the UrBackup server package. Open a terminal session on your NixOS machine and run the following commands one at a time.

sudo nix-channel --update

sudo nix-env -iA nixos.urbackup-server

The channel update ensures your package sources are current, while the installation command adds the UrBackup server package to the system. Depending on your connection speed and system performance, this may take a few minutes.

Configure the UrBackup Server

After installation, you should review the UrBackup configuration so it matches your backup strategy. The main configuration file is located at /etc/urbackup/urbackup_server.conf. Open it with a text editor such as Nano.

sudo nano /etc/urbackup/urbackup_server.conf

Inside the configuration file, you can customize important settings such as:

  • The storage location for backups
  • Retention rules for old backup sets
  • Backup intervals and scheduling preferences
  • Other server-specific options based on your environment

Once you finish editing the file, save the changes and exit the editor.

Start the UrBackup Service

When the configuration is in place, start the UrBackup server with systemd.

sudo systemctl start urbackup_server

If you want the service to launch automatically when the server boots, you may also choose to enable it in your system configuration according to your NixOS service management preferences.

Verify the Installation

To confirm that UrBackup is running on NixOS, open a browser and go to the server's web interface at http://<your-server-ip>:55414.

Replace <your-server-ip> with the actual IP address of your NixOS system. If everything is working as expected, the UrBackup login page should appear, indicating that the backup server is active and ready for setup.

Troubleshooting Tips

If the UrBackup web interface does not load, check the following:

  • Confirm the service started successfully
  • Verify that port 55414 is accessible through your firewall
  • Review the UrBackup configuration file for syntax or path issues
  • Make sure you are using the correct server IP address

Conclusion

Installing UrBackup on NixOS is a straightforward process that gives you a powerful backup server for protecting critical data. By updating your package channels, installing the UrBackup server package, adjusting the configuration, and starting the service, you can quickly deploy a dependable backup management system. Once the web interface is available, you can continue refining your backup policies and begin securing your systems with UrBackup on NixOS.