/
Git Instance

Git Instance

Owned by Aryn Wiebe
Last updated: Jan 13, 2025
2 min read

The Git Instance settings page allows you to integrate Git source control with your IguanaX instance. All Iguana configurations and settings are stored in a Git repository that you define.

Connecting IguanaX to a Git repository enables:

  • Tracking Configuration Changes: View the Commit History to monitor changes across your IguanaX instance.

  • Automatic Backups: Regularly back up your instance to a Git repository for safe storage.

  • Disaster Recovery: Quickly restore or spin up a new IguanaX instance using pre-existing configurations from your repository.

  • Efficient Deployment: Deploy fully pre-configured IguanaX instances across environments. 

Connect IguanaX to a Git repository to store all instance configurations.

  1. Configure the Git Instance: To add an instance repository, click Edit and either provide an existing repository URL or create a new repository in the Repository Management Screen.

  2. Manually Backup your Iguana: Use the git push button to manually perform a git push to push changes from the IguanaX instance to the Git repository. This is useful when you want to ensure immediate backup of the current state of your instance.

Any components or libraries not connected to a repository or configured as a plain folder will not be pushed to the Git Instance repository. If this occurs, a Push Warning will display to remind you that the following components were not backed up.

IguanaX can automatically create Git commits when certain actions are taken (such as deleting components) to ensure regular snapshots of your instance’s configurations. You can set an interval in minutes for automatic Git pushes to back up changes. If set to 0, auto-backups are disabled.

Define the user with the appropriate permissions to push changes from the configured Git repository. This ensures that your IguanaX instance can securely interact with the repository.

Use Reset Instance to completely replace your current IguanaX instance configurations with those stored in the defined Git repository. When you reset the instance, IguanaX performs a git pull, pulling the repository's contents, which overwrites the current configurations.

 

Related content