Skip to content

Migration Guide

Jump to bottom
Rich Brown edited this page Jun 4, 2026 · 4 revisions

Migration Guide

Read these tips if you are moving from a Network Controller installation or moving Unifi OS Server from a different machine to this one. (Important: If the new server will be on a different IP address, see the inform address note below.)

Migrating from Network Controller

The easiest way to migrate from UniFi Network Controller to UniFi OS Server is to use backup and restore:

  1. Backup Network Controller config
  2. Shutdown Network Controller
  3. Start UniFi OS Server
  4. Select Restore from Backup on the setup page and upload your .unf backup file

Migrating from UniFi OS Server Native Installation

To migrate from a standard (podman-based) installation of UniFi OS Server as provided by UniFi, follow the same backup and restore steps as above.

To migrate existing history, see #53.

Network Version Mismatch

If your backup file is from a newer Network version than what's bundled with UniFi OS Server, restore will not work. You will first need to:

  1. Setup UniFi OS Server without restore, using a temporary local user
  2. Navigate to Settings > Control Plane > Updates and update Network
  3. Restore backup from Settings > Control Plane > Backups > Restore

Updating the Inform Address

If you're planning to run Unifi OS Server on a different host or changing its IP/domain name, you must update the inform address for all Unifi devices prior to migration. If you do not, devices that become isolated may not be able to re-connect, and may require considerable reconfiguration to restore.

Clone this wiki locally