Export and import apps

Methods for moving an application or backing up the design and data of an application

Use the methods below to move a Budibase App from one Budibase installation to another, or to backup the design and data in your App. Admins and Developers can export any app as a JSON blob text file.

The exported file will include all Budibase DB data, data connector configurations, query configs and builder data for all your screens.

🚧

Security

When exporting a production app, be vigilant about whom you share the app export files with.
Are you confident you won't be leaking database credentials, user identity information, authentication keys, or any other sensitive information?

We also recommend that you make use of the password based app export encryption.

Export an application

To export an app, click on the Manage button in the app list

This will bring you to the overview screen. From here you can expand the ellipsis and choose:

  • Export latest will export the development version of your app including any changes since your last publish
  • Export published will export only the last published version of your app

After choosing an export option you will be given the choice for Exclude Rows. This will exclude all the data rows from your internal Budibase DB tables in the export, however datasource configuration and credentials will still be exported.

πŸ‘

Environment variables

By using Environment variables πŸ”’, you can exclude secrets and datasource credentials from your app exports.

Import an application

You can create an app by importing an app export file.

Within the Apps screen, click the Create new app button. From here, click on the Import app button:

This will present a modal, into which you can drag the app export file, and click Import app to finish.

πŸ‘

Backups

App backups πŸ”’ can be imported in the same way you would import a manual export.

The benefit of using backups is that they will automatically be created when publishing your app.

Import an application and retain your users table

If you need to retain your users and data tables, but override your screens and automations, you can import your screens and datasources within your application settings.