Workspace management

Managing your cloud and self-hosted workspaces and subscriptions

Once you've created an account with Budibase, you will be able to create and manage multiple workspaces between Budibase cloud and self-hosted.

A workspace is a collections of apps, users, settings and roles that are tied to an environment.

When you login to your account, you will see a list of your workspaces under the Workspaces tab.


Cloud hosted workspaces

A cloud hosted workspace

A cloud hosted workspace


Each cloud hosted workspace is hosted by us, and given a unique URL, where the workspace can be accessed. You can also navigate to the workspace from the account portal by clicking the Go to workspace button.

You can also see the Subscription, which will always initially be Free tier. Click the Upgrade subscription button to upgrade your workspace plan to get the full suite of Budibase features. You can choose between monthly payment, or annual.

Once the workspace subscription has been activated, the green light will appear. It may take a minute for the subscription to activate.

Cloud workspace on the Premium plan

Cloud workspace on the Premium plan

Each workspace has it's own subscription. Whenever you buy a subscription, it will unlock the features and increase quotas on a per workspace basis.

To add a cloud workspace, click the Add workspace at the top of the page, and select Budibase cloud. You will then be prompted to enter a unique URL.

You can only have one Free tier workspace. If you have an existing free-tier workspace, you must upgrade it before adding an additional one.

To delete the workspace, click the bin icon in the top right of the tile, and confirm.

🚧

Deleting a cloud workspace is not reversible

Once you delete a cloud workspace, you will lose any apps and users associated with it.

A cloud workspace that has an active subscription cannot be deleted.


Self hosted workspaces

For full control of your data, you may wish to self-host. This means that you will install Budibase on your own infrastructure, or hosting provider.

In order to unlock the full set of features and remove limits, you must link your installation to your account. This is done by adding a self-hosted workspace:

  1. Click the Add workspace button
  2. Select Self host
  3. Enter a name to help you remember which installation this workspace will be linked to
Give your self-host workspace a memorable name

Give your self-host workspace a memorable name

  1. Click I have installed budibase when your installation is ready to be linked
  2. You will then be presented with your license key - copy it.
This modal will wait for you to paste the license key into your installation

This modal will wait for you to paste the license key into your installation

  1. Visit your installation, and navigate to the Upgrade tab of the Account section. Paste in your key and click Activate
  1. Now back in your account workspace page, you should see the message License successfully linked. Click Done to finish. Your workspace is now ready to be upgraded!
License linked

License linked

Now you can upgrade your workspace. A green light beside the Subscription when the subscription is active.

Premium subscription

Premium subscription

To get the features and quotas to update in your installation, navigate to the Upgrade tab of the Account section. Under Plan, click the Refresh button, and you should see the plan type update.

Installation will show the old plan until your 'Refresh'

Installation will show the old plan until your 'Refresh'

After refreshing your upgraded plan will be applied to the installation: