Skip to content
François Côte edited this page Nov 22, 2026 · 2 revisions

Welcome to UrsaNAS

UrsaNAS turns a computer into a network storage box ("NAS") that your other devices — phones, laptops, TVs, media players — can use to store and read files over your home network. Everything is managed from a web page, so you never need to type commands.

This wiki is written for the person running the NAS, not for a technician. It explains what each page of the interface does and why you'd use it, without going into the technical details behind it. To see UrsaNAS in pictures before installing it, visit the presentation site.

Where to start

New to UrsaNAS? Read Getting Started first: it covers installing UrsaNAS and signing in for the first time.

What's where

Everything is reached from the desktop: one icon per feature, and each feature opens in its own window. The features are organised into a few areas, listed here in the order you'll usually use them:

Area What it's for
The Desktop How the desktop, its windows, the taskbar and the top bar work.
Appearance Choosing colours, light or dark theme, and a wallpaper.
Storage Preparing the disks that hold your files, and organising them into pools and folders.
Sharing Files Making a folder available to your other devices over the network.
File Manager Browsing, moving and organising your files from the browser itself.
Accounts Who can sign in to this interface, and who can access your shared folders.
Backups Copying your files to an external disk, automatically.
Remote Storage Connecting the NAS to another server or to an online storage service.
Virtual Machines Running a full extra computer (with its own operating system) on the NAS.
Docker Apps Running small ready-made applications on the NAS.
Network Checking and adjusting how the NAS connects to your network.
Alerts and Activity Being notified when something needs attention, and seeing what changed recently.
System Settings Keeping UrsaNAS itself up to date, and backing up its configuration.

If something isn't working as expected, see Troubleshooting.

The first screen: the desktop

After signing in you land on the desktop. To get a quick look at the machine, open the Dashboard icon. It gives you an at-a-glance health check of the machine itself: how long it's been running, how hot the processor is, how much memory and storage space is used. You don't need to act on anything here unless a number looks unusually high — it's just a quick way to confirm the NAS is healthy.

Restarting or shutting down

The power button in the top-right corner of the screen lets you Restart or Shut down the NAS. Use shutdown before unplugging the machine or moving it.

Clone this wiki locally