Upgrading Self-Hosted Spacelift to Use New Provider Features

Last updated: July 14, 2025

When using newer features of the Spacelift Terraform provider (like scheduled_run), you need to ensure your self-hosted Spacelift installation is compatible with the provider version you want to use.

Checking Your Current Version

You can check your current self-hosted version in the UI under Account Details → Self Hosted Version.

Version Compatibility

Each self-hosted version is compatible with specific versions of the Terraform provider. For example:

  • Self-hosted v0.0.9 is compatible up to provider version 1.3.1

  • Self-hosted v3.1.0 is compatible with provider version 1.25.0 and newer

Upgrading Process

  1. Check the changelog to understand changes between versions

  2. Review the upgrade documentation

  3. Request the installation package from Spacelift support if needed

  4. Follow the installation guide to perform the upgrade

When upgrading from older versions (pre-v3.0.0), it's recommended to contact Spacelift Support for assistance due to potential compatibility issues during the upgrade process.

After Upgrade

After upgrading:

  • Log out and log back in to ensure all UI features work correctly

  • Verify that your stacks are functioning as expected

  • Test any new features you plan to use (like scheduled_run)

If you encounter any issues during or after the upgrade, contact Spacelift Support for assistance.