Repository navigation
Home
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.
New to UrsaNAS? Read Getting Started first: it covers installing UrsaNAS and signing in for the first time.
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.
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.
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.
Start here
Using UrsaNAS
Files
People
Running software
The NAS itself
Help