How-to guide
Restore or move your organization
Replace everything in an organization with a backup, to recover from a disaster or to move the organization to another Sovrain.
This guide loads a backup into an organization and replaces everything in it. Use it to undo a disaster with a backup of the same organization, or to move an organization: you load its backup into an organization on another Sovrain.
Only owners can import a backup. The Import card on the Backup page is not shown to other admins; see Roles.
Warning: An import replaces all users, groups, attributes, applications, signing keys and the custom domain of the organization with the backup’s. It is not a merge. Everyone, you included, is signed out and signs in with the passwords from the backup. There is no undo from the admin pages.
Before you start
- If the organization you are about to replace still works, back it up first: Back up your organization. That backup is your only way back.
- To move an organization, first create the organization you will import into on the other Sovrain. It keeps its own address; the organization name and everything else come from the backup.
Get a backup this organization can read
The backup must be encrypted to the Import key of the organization you import into, or not encrypted.
- Sign in as an owner of the organization you import into. On your home page, under Administration, select Open admin, then select Backup in the admin menu.
- Under Import, select Copy next to Import key.
- In the organization you back up, paste the key into age public key and export, as in Back up your organization.
The import key is valid for 24 hours. New key replaces it.
If the backup is encrypted with your own age key, decrypt it first:
age -d -i backup.key org-acme-20261117-0930.json.age > org.json.
Import the backup
- On the Backup page of the organization you import into, under Backup file, select Choose file and
pick the
.json.ageor.jsonfile, up to 50 MB. - In Type acme to confirm, type your organization’s address as shown, for example
acme. - Type Your password.
- Select Import and replace everything.
Sovrain shows The backup is imported. with the number of users, groups, applications and signing keys, and signs everyone out. Sovrain allows one import every 5 minutes.
After an import
- Sign in with an account from the backup.
- Second steps were not in the backup. Everyone sets up two-step sign-in again; people who must use it are asked at their next sign-in.
- Delegations and API access are gone. Create them again where needed.
- Invitation links and password reset links sent before the import no longer work. Resend open invitations.
- Each SCIM connection runs a full resync. Open each provisioning application and run Test connection.
Related
- Export format, with what an import does step by step, and Limits.
- Back up the data volume, for operators running Sovrain themselves.
- About Sovrain’s security model.