SplatDev.Umbraco.Plugins.Backups 3.3.1

SplatDev.Umbraco.Plugins.Backups

A comprehensive backup plugin for Umbraco that lets you create, schedule, and restore backups directly from the backoffice. Supports multiple cloud storage providers.

Compatibility

Features

• Create full or partial backups from the Umbraco backoffice
• Schedule automatic backups via CRON expressions
• Restore from any stored backup
• 10+ cloud storage providers out of the box:
  • Azure Blob Storage
  • Amazon S3
  • Dropbox
  • Google Drive
  • OneDrive
  • Box
  • Mega
  • Seafile
  • SFTP
  • Local file system
• Backup retention policies (keep N most recent backups)
• Email notifications on backup success/failure

Installation

dotnet add package SplatDev.Umbraco.Plugins.Backups

Or via the Package Manager Console:

Install-Package SplatDev.Umbraco.Plugins.Backups

Quick Start

Add to your Program.cs (or Startup.cs):

builder.CreateUmbracoBuilder()
    .AddBackOffice()
    .AddWebsite()
    .AddBackups()  // Add this line
    .Build();

Then configure in appsettings.json:

{
  "SplatDev": {
    "Backups": {
      "Enabled": true,
      "RetentionDays": 30,
      "CloudProviders": [
        {
          "ProviderType": "AzureBlob",
          "Enabled": true,
          "Settings": {
            "ConnectionString": "DefaultEndpointsProtocol=https;...",
            "ContainerName": "umbraco-backups"
          }
        }
      ]
    }
  }
}

Configuration

Azure Blob Storage

{
  "ProviderType": "AzureBlob",
  "Enabled": true,
  "Settings": {
    "ConnectionString": "<your-connection-string>",
    "ContainerName": "umbraco-backups"
  }
}

Amazon S3

{
  "ProviderType": "S3",
  "Enabled": true,
  "Settings": {
    "AccessKey": "<access-key>",
    "SecretKey": "<secret-key>",
    "BucketName": "umbraco-backups",
    "Region": "us-east-1"
  }
}

SFTP

{
  "ProviderType": "SFTP",
  "Enabled": true,
  "Settings": {
    "Host": "sftp.example.com",
    "Port": "22",
    "Username": "backupuser",
    "Password": "<password>",
    "FolderPath": "/backups"
  }
}

Dropbox

{
  "ProviderType": "Dropbox",
  "Enabled": true,
  "Settings": {
    "AccessToken": "<access-token>",
    "FolderPath": "/Backups"
  }
}

Mega

{
  "ProviderType": "Mega",
  "Enabled": true,
  "Settings": {
    "Email": "your@email.com",
    "Password": "<password>",
    "FolderPath": "Backups"
  }
}

Backoffice

After installation, navigate to Settings → Backups in the Umbraco backoffice to:

• Run backups on demand
• Configure scheduled backups
• View backup history
• Restore from a backup
• Test cloud provider connections

License

MIT — see LICENSE for details.

Contributing

Issues and PRs welcome at github.com/SplatDev-Ltda/SplatDev.Umbraco.Plugins.\n\n## Changelog\n\n### 3.3.1 — 2026-08-21

• The dashboard can now take a backup. It previously made no requests at all — it showed a hardcoded "Active" badge and a Save button that set a flag for three seconds and wrote nothing — while the API underneath supported all of this the whole time.
• Choose what to include (content, media, database), whether to compress, whether to encrypt and with which key, which cloud providers to copy to, and whether to keep a local copy.
• Restore from any listed backup, choosing scope, whether to overwrite existing items, and supplying the decryption key when the archive is encrypted.
• Delete backups, and test a cloud provider's credentials before relying on it.
• Four endpoints moved: CreateAdvanced, Restore, GetCloudProviders and TestProvider had action-level route templates that appended to the controller prefix, so they lived at URLs like /umbraco/api/backups/GetCloudProviders/providers. They now sit at /umbraco/api/backups/<Action> with the rest. No shipped UI called them, so nothing that worked before stops working.