Mosaic Model Version Control with Bitbucket
Starting in Strategy One (November 2026), you can manage Mosaic models as version-controlled artifacts using Bitbucket.
Prerequisites
Privileges
Your Strategy account must have the Manage Git Integration and Use Git Integration privileges.
Bitbucket Repository
You must create a repository in Bitbucket:
-
In Bitbucket, click Create New... and choose New repository.
-
Type a Repository name and note the URL.
For example,
https://bitbucket.org/{bitbucket_account}/repository name.
Bitbucket OAuth Application
You must create a Bitbucket OAuth App so Strategy can authenticate with Bitbucket on behalf of users:
-
Sign in to Bitbucket.
-
Go to your Workspace Settings.
-
In the left navigation, click Apps and features and OAuth clients.
-
Click New OAuth app.
-
In the Authorization tab, enter values in the following fields:
-
Authorization code: Check this value.
-
Callback URLs: Type the URL where Bitbucket will send users after they authorize. You can update this value according to your Library URL. This field is required.
For example,
https://host.company.com/MicroStrategyLibrary/auth/DIOAuthRedirect.jsp.
-
-
In the Scopes tab, select the check box next to Write in Account, Workspace membership, and Pull requests.
Select other scopes, as needed.
-
The Client ID displays on the app page. Note this value.
The Client ID value is referred to as
BITBUCKET_CLIENT_IDin future steps. -
Click Generate a new client secret.
-
Copy the client secret value and securely store it. For example, using environment variables or a secret manager.
The client secret is referred to as
BITBUCK_CLIENT_SECRETin future steps.
Configure Strategy
Create an Identity and Access Management (IAM) Object
Create an IAM configuration is Workstation using the GitHub OAuth App credentials you noted above.
-
Open Workstation.
-
In the Navigation pane, click Enterprise Security.
-
Click Add Gateway Authorization.
-
Type a Display Name.
-
In 1. Select an identity provider, choose Bitbucket.
-
In 3. Strategy Configuration, add the Client ID, Client Secret, OAuth URL, and Token URL.
-
Client ID: Enter the
BITBUCKET_CLIENT_IDvalue from the Bitbucket OAuth App you noted above. -
Client Secret: Enter the
BITBUCKET_CLIENT_SECRETvalue from the Bitbucket OAuth App you noted above. -
OAuth URL: Type
https://bitbucket.org/site/oauth2/authorize. -
Token URL: Add a token URL using the following format:
https://bitbucket.org/site/oauth2/access_token.
-
-
Click Save.
Configure Git Integration in Library
-
In Library, click Account settings.
-
Choose Git Integrations.
-
Click Add New Integration.
-
Type a Display Name.
-
In 1. Select a Git Provider, select Bitbucket.
-
In 2. Repository Configuration, enter values in the following fields:
-
Repository URL: Enter the Bitbucket repository URL.
-
Branch: Type the branch you want to use with Mosaic.
-
Folder: Optionally enter the name of the folder you want to use with Mosaic.
-
-
In 3. Authentication Configuration, choose the IAM object you created above.
-
Click Save.
Use Bitbucket with Mosaic Studio
Save to Bitbucket
You must have the Use Git Integration privilege, Read access to the model, and the integration must be configured for the environment.
-
In Library, right-click the model.
-
Choose Save to Bitbucket.
-
Type a commit message.
-
Click Save.
-
After the version is saved, close the Save Version dialog.
Restore from Bitbucket
Pull a version of the model from Bitbucket and apply it to Strategy.
You must have the Use Git Integration privilege, Write access to the model, and the integration must be configured for the environment.
-
In Library, right-click the model.
-
Choose Restore from Bitbucket.
-
Select a version from your version history.
-
Optionally click Preview to view a sample of the data in Mosaic Studio.
-
Click Restore and Restore.
-
After the restoration is complete, close the dialog.
