BETA — Open to testers. Tell us what to fix on @vomehome or via a tester code.

Media and network storage after a move

Why shares that pointed at your old machine always fail on a new one, and where to put a media library so both ends can reach it.

Updated 28 August 2026 storagemigrationmedia


Network storage settings travel inside your backup exactly as they were written. If a share pointed at the old machine itself — anything using localhost or 127.0.0.1 — it cannot work anywhere else, and will show as failed after a restore.

This is worth knowing in advance because it is entirely predictable: a share whose server is "this very machine" can only ever work on that machine.

Where to put it instead

Before Share on localhost only the old machine could ever see it After Share on a real address datacentre disk, or LAN not a USB disk that left
A share pointing at localhost means "this very machine". An address both ends can reach is what makes the library survive the move.
  1. Put the files somewhere reachable from the new machine. A share on a portable disk attached to the old box will vanish with it.
  2. Share it over SMB with a dedicated user.
  3. In Home Assistant: Settings → System → Storage → Add network storage, using an address both ends can reach rather than localhost.
  4. Repoint any media applications at the new location.

The library does not need to stay in the house

A portable hard disk or a NAS you have to operate was the answer to a bandwidth problem. Most household lines are now hundreds of megabits; a disk in a datacentre is the better copy — powered, backed up, and not sitting in a cupboard. The trap this page is about is still the same: localhost means the old machine, wherever you intended the files to live. The longer argument is sovereignty is not a cupboard.

Rather not do this alone?
The Vome assistant will walk you through this guide a step at a time, and can do some of it for you.
Sign in for AI help

Something wrong or missing here? Tell us — these pages are written from real work, so corrections are welcome.