Manage Source Control deployments

Learn how to manage and monitor Source Control deployments on your self-hosted Retool instance.

🚧

Requirements

This feature requires Self-hosted Retool v2.97 or greater.

Organizations that use Source Controlβ€”a branch-based workflow for managing and deploying changes to Retool appsβ€”can use the Deployment Dashboard to view the status and details of deployments, download logs for further information, and manually deploy the latest changes.

View Source Control deployments

The Deployment Dashboard contains the following details about the most recent deployments (up to 100) for your self-hosted instance.

DetailDescription
StatusWhether the deployment was successful or failed.
CommitSpecific commit SHA on the main branch of the Source Control repository that is deployed.
Triggered byWhether the deployment was triggered automatically by Retool or manually by a user.
Started atDate and time that the deployment started.
DurationTotal time for the deployment to run.
LogsDownloadable log file for the deployment.

Viewing deployments

Source Control status

The Deployment Dashboard also includes details about your instance's Source Control configuration. You can review the current configuration, test the connection to the source control management (SCM) provider, or edit the configuration.

Full and Partial deployments

The Deploy section displays the commit SHA that is currently deployed.

Admin users can manually trigger Full deployments by clicking Deploy latest. This syncs the latest state of all protected elements in your remote repository's main branch to Retool.

Full deployment

Retool uses the jobs runner to poll for changes in your remote repository's main branch every 10 seconds. If any changes are detected, Retool automatically kicks off a Partial deployment to sync updated elements to Retool.

Partial Deployment