If you've enabled Git Syncing, disable it:
- In your
- In the Settings > Advanced tab in Retool, remove the repository URL and branch name from your Git Syncing configuration.
This guide requires access to a Bitbucket account with permissions to create workspaces and repositories.
- Create a Bitbucket app password.
- On the app password page under Permissions > Repositories, select Read, Admin, and Delete. This gives the app password the ability to access and modify the repository containing your Retool apps.
- Create a Bitbucket workspace for your Retool repository.
- Create a Git repository in Bitbucket for your Retool apps.
Set the following environment variables on your Retool instance.
|The Bitbucket user name||retool|
|The app password you generated in step 1||loDJlwRetoolTYXOFbO|
|The workspace name in step 2||retool-space|
|The repo name in step 2||retool-apps|
|Retool will automatically track changes to this branch||main|
Once you set up your environment variables, if you’re an admin on your Retool instance, you can visit Settings > Source Control.
If your Bitbucket environment is correctly configured, the page will show your Bitbucket commits in the Deployment Dashboard section. You can also click the Test connection button, which sends a request to test the connection.
If you don't see the Deployment Dashboard and your Bitbucket commits on Settings > Source Control, check that your environment variables are correctly configured.
You are now ready to use source control. Learn how to create branches, pull requests, merging changes, and use other source control features in the getting started guide.
Updated 4 days ago