Create and restore application backups

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.


To backup, follow the steps below:

  • Log in to the application as an administrator.

  • Select the “Admin -> Backups” menu item.

  • Click the “Backup” button.

    Discourse backup

It is possible to create a backup with or without uploaded images. Note this process could take some time depending on your database and the size of the uploaded files.

Once the backup has been created, download the backup file and store it in a safe location.


Restoring a backup in Discourse is disabled by default. To restore, follow the steps below:

  • Log in to the application as an administrator.

  • Enable restoration using the “Settings -> Backups -> Allow restore” menu.

    Discourse restore

  • Select the “Admin -> Backups” menu item.

  • Upload the backup file and restore its contents.

IMPORTANT: Restoring Discourse backups requires the bn_discourse user’s password from the Discourse discourse.conf configuration file. Depending on your installation type, this file can be found in the following locations:

  • Approach A (Bitnami installations using system packages): installdir/discourse/config/discourse.conf

  • Approach B (Self-contained Bitnami installations): installdir/apps/discourse/htdocs/config/discourse.conf

You can provide this password by running the following command in your terminal window:


Last modification June 16, 2021