Create download and restore a backup of your Discourse database

Discourse allows site administrators to create and download a copy of the site’s database. The backup can then be uploaded and restored to any Discourse forum.

Create the backup

Go to the Admin / Backups section of your site and click the Backup button.

A modal window will open asking you whether or not you would like to include the site’s uploads in the backup.

:warning: If your site is hosted by us and you would like to create a backup that includes uploads, contact the Discourse team before creating the backup.


Click either of the ‘Yes’ buttons to initiate the backup.

Download the backup

When the backup is complete, Discourse will send you a notification.

Click the link in the notification to return to your Backups page. Then click the Download button.

Discourse will then send you an email that contains a link that can be used to download the backup to your computer.

Clicking the link will open your browser’s file manager and allow you to save the backup to your computer.

Upload a backup

To upload a backup, go to the Admin / Backups section of your site and click the Upload button.

This will open your browser’s file manager. Select the backup from your file system and click the file manager’s Open button. The new backup file will be displayed in the file list.

Restore a backup

:warning: If your site is hosted by us, the Restore button in the screenshot below will be disabled. Contact the Discourse team and let us know the name of the backup file that you wish to restore. We will restore it for you.

:warning: Restoring a backup file will overwrite all data on the site. When the backup is restored, you will be logged out of the site and need to log back in with your credentials from the restored site.

If you are not one of our hosted customers, click the Restore button to restore the backup on your site.