Cloud backup
Cloud backup keeps an encrypted copy of your library away from your home, so a failed disk, fire or theft doesn’t cost you your photos. Your Cloud plan includes 1 TB of Frameleaf-managed storage, or you can back up to a compatible storage bucket you manage yourself. It’s in addition to Manager’s database-only backup.
Licence and plan
Section titled “Licence and plan”Managed Cloud Backup needs both a live Cloud plan and a supporter licence activated on the linked server; neither works on its own. A Server licence covers every account on that server; an Individual licence covers only its owner’s own account. On older server releases, new backups need a Server licence, so update your server before relying on Individual coverage. Your own storage bucket has its own setup.
Turn it on
Section titled “Turn it on”Open Settings, then Backup, or Frameleaf Cloud, then Cloud backup, and start the Cloud backup setup.
- Choose Frameleaf-managed storage or your own supported storage bucket.
- Check the storage address and credentials. Your own bucket needs to support the encryption the setup screen asks for.
- Choose whether to generate your encryption key or supply your own.
- Save your recovery file somewhere away from this server and complete the confirmation. For Frameleaf-managed storage this is a key file you download or copy; for your own bucket it’s the key file or recovery kit the setup screen shows.
- Check what will be backed up, the schedule and retention, then enable it.
- Run the first backup, then do a restore check.
If you go back and change the destination, setup creates a new recovery file. Save the new one; the file you saved for the earlier destination won’t open this backup.
Choose how the key is kept
Section titled “Choose how the key is kept”You can let the server generate a key or supply one yourself. The setup screen explains how to recover with each option. If you choose not to save the key on the server, you enter it again when the server restarts or when you restore.
For a server-generated key, you can also keep an escrow copy. Save its passphrase and a separate recovery copy. Keys you supply yourself are never escrowed.
How your backup is encrypted
Section titled “How your backup is encrypted”Your server encrypts every file, the list of your file names and the database copy before anything leaves your home, with keys only you hold. This is the same for Frameleaf-managed storage and your own storage bucket, and there’s nothing to turn on.
The storage provider, and Frameleaf for managed storage, can see how many encrypted objects there are, their sizes and when they were written. They can’t see file names, folders, albums, people or contents: even the object names are scrambled with your key.
Your own storage bucket needs versioning turned on and support for customer-provided encryption keys (SSE-C), which Frameleaf uses only to claim the bucket. Add a lifecycle rule that removes old versions after a few days so cleaned-up backups stop using space.
Buddy backup also encrypts everything on your server before it leaves.
Keep the complete recovery file
Section titled “Keep the complete recovery file”For a backup your server encrypts, the recovery file holds everything needed to read it: every key version your retained backups use and the trusted history of your snapshots. Keep the whole file, not just a code from it, on another device or offline. Save a fresh copy after you change keys or destinations, and after backing up: Update recovery file on the Cloud Backup page takes your saved file and gives it back with your latest backups added, which a new server needs to open your newest backup. If you keep an escrow copy with Frameleaf and change keys, the Cloud Backup page shows Recovery copy is out of date: store it again with your passphrase.
If the server restarts or is replaced and doesn’t have the key, load the complete recovery file before new backups can run.
What’s backed up
Section titled “What’s backed up”Coverage follows your activated licences, account by account; you don’t choose individual albums, people or dates. The database copy always covers the whole library, even when only some accounts’ originals are covered. Generated previews and transcoded media have their own options.
External libraries and folders outside the managed library need their own backup plan, so check whether yours are covered.
A backup is complete when its restore point is published and verified, not just when uploads finish. Check the latest completed restore point and its verification result, and look into any missing files.
Schedule, retention and checks
Section titled “Schedule, retention and checks”Set the schedule and retention on your server. Keep enough restore points to recover from a mistake you only notice later, and keep an eye on free storage and the last successful run.
Run a restore check after setup, after changing keys or destinations, and regularly after that. Keep any verification report you download with your recovery records.
Monthly restore drill
Section titled “Monthly restore drill”Frameleaf proves your Cloud Backup would restore with a Restore drill, for Frameleaf-managed storage and your own bucket alike. About every 30 days it runs one by itself, straight after a scheduled backup finishes, so it stays inside your backup schedule. After a failed drill it tries again a day later. You can also choose Run a drill now.
A drill changes nothing in your library and usually takes a few minutes. It works in a scratch copy that’s removed afterwards:
- Fetch a sample from your backup: the newest backup, checked against its trusted history.
- Unlock it with your recovery key.
- Rebuild the library data in a scratch copy, and check the sample is in it.
- Compare the sample with the originals: up to 500 photos and videos chosen at random.
The Restore drill card is on the Restore page of Settings, then Backup, with the last and next drill:
| The card says | What it means |
|---|---|
| Your backup restored correctly | Every photo and video in the sample matched, and the library data rebuilt. |
| Your backup didn’t restore | The drill stopped at one step: Frameleaf couldn’t fetch the sample from your backup, The recovery key on this server didn’t unlock the backup (with Check the recovery key), The library data in the backup couldn’t be rebuilt, or Some photos in the backup didn’t match the originals. Your backups keep running, and the Overview lists it as something that needs you. |
| Your backup hasn’t been proven to restore yet | No drill has run yet. |
See the report opens the Restore drill report: what was checked step by step (steps after a failure show Not reached), the backup used, the library at the time, how many matched and didn’t, how long it took, and the key the server signed the report with. Download report saves it as a signed file; anyone you send it to can check it came from this server and wasn’t changed. Print prints the report on its own.
After each drill that runs by itself, passed or failed, every administrator with email notifications on gets an email with the result. A drill you run by hand doesn’t send one.
Restore
Section titled “Restore”- Choose the restore point and what to restore.
- Check the destination and any conflicts.
- Confirm.
When you can, restore a sample to a separate folder first. A full database recovery replaces accounts, albums and settings as well as media references.
You don’t have to restore a single lost photo yourself. When a photo’s original goes missing, or its file changes after Frameleaf stored it, Frameleaf finds the original in your newest backup that has it and puts it back where it was. It’s checked against the photo first and never replaces another file. See Damaged and missing files.
If your server is lost, use your release’s recovery tools and your saved key. See Backup and restore and Server commands.
Keep an offline copy you control
Section titled “Keep an offline copy you control”You can export a complete copy of a managed backup to a drive you own while the server is still working. You can then rebuild on a new server from that copy without Frameleaf Cloud, storage credentials or a working Cloud account. See Export a managed backup.
When your backup grows
Section titled “When your backup grows”Every plan includes 1 TB. When you need more, storage grows automatically in started 1 TB blocks at $9.99 per block per month, billed monthly even on an annual plan. Frameleaf emails you when a block is added, and backups never stop for size. Licence discounts don’t apply to extra storage. Plans bought through the App Store or Google Play come in fixed sizes of 1, 2, 3 or 5 TB; change the size in the Frameleaf app.
If a backup pauses, the status tells you why. Fix the cause and check that the next run succeeds. Your local library keeps working either way.
Read-only states
Section titled “Read-only states”If your last qualifying licence ends, new managed backup writes stop, but your existing backup data, keys and restores stay available and nothing is purged. Reinstate a qualifying licence and writes resume while your plan is live. Cancelling the plan has its own retention and deletion rules.
Unlinking, billing changes, a deletion request or a missing recovery key can also limit new backups or recovery. The service shows the current status and retention deadline. Recover anything you need before you cancel or delete a destination.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.