Cloudback Docs
HomePricingBlogContactSign In
  • Getting Started
    • What is Cloudback?
    • Installation Guide
    • First Backup Walkthrough
  • Managing Backups
    • Automated Daily Backups
    • Metadata Backups
    • One-Click Manual Backups
    • Setting Backup Schedules
    • Manage Backup Storage
    • Backup Retention Policy
    • Password-Protected Backups
    • Account Settings
    • Bulk Operations
    • Data Deduplication
    • Email Notifications
    • Instant Notifications
    • Archive Name Pattern
  • Data Restoration
    • Download Backups
    • Restore to GitHub
  • Automation
    • Terraform Provider
    • Operations API
  • Dashboard
    • Dashboard Overview
    • Card view
    • Table view
    • Repository Details
    • Backup Details and Metadata
    • Backup Status Badge
  • Storage Configuration
    • Cloudback Managed Storages
    • Customer Managed Storages
    • Replicating Backups
  • Supported Storages
    • Alibaba Cloud Object Storage Service
    • Amazon S3 Bucket via Access Key
    • Amazon S3 Bucket via Access Point
    • Amazon S3 Glacier
    • Amazon S3 Object Tagging
    • Google Cloud Storage Bucket
    • Microsoft Azure Blob Container
    • Microsoft OneDrive Business
    • Microsoft OneDrive Personal
    • OpenStack Swift
    • Wasabi Customer Managed Storage
  • Account and Billing Management
    • Payment Methods
    • GitHub Organizations
    • Invoiced Customers
  • Troubleshooting and Support
    • Known Issues
    • Contact us
  • Security Features
    • Access Review: Vanta Integration
    • Immutability: Amazon S3 Object Lock
    • Encryption: Password-Protected Archives
    • Traceability: Audit Log
  • Legal
    • Terms of Service
    • Privacy Policy
Powered by GitBook
LogoLogo

Learn more

  • Integrations
  • Blog

Explore

  • Roadmap
  • Changelog

Support

  • Contact Us
  • Status

Legal

  • Terms of Service
  • Privacy Policy

© 2025 Cloudback

On this page
  • Overview
  • Features
  • Prerequisites
  • Usage
  • Provider Configuration
  • Resource: Backup Definition
  • Documentation
  • References

Was this helpful?

  1. Automation

Terraform Provider

PreviousAutomationNextOperations API

Last updated 1 month ago

Was this helpful?

The Cloudback Terraform Provider (terraform-provider-cloudback) is an Infrastructure as Code (IaC) tool that enables automated management of Cloudback backup configurations through .

Overview

This provider allows users to manage GitHub repository backup definitions using Cloudback's through Terraform configurations. It provides a seamless integration between Terraform and the Cloudback platform.

Features

  • Automated backup definition configuration for repositories

  • Infrastructure as Code approach to backup management

  • Support for Terraform-based workflow automation

Prerequisites

Before you begin, ensure that you have the following:

  • Terraform Installed: Version 1.0 or later is recommended.

  • Cloudback Account: An active account with appropriate permissions to create and manage backup resources.

  • API Key: Your API key for Cloudback’s API. You can create one at the page in the Cloudback dashboard.

  • Network Access: Ensure that your environment can reach Cloudback’s endpoints: https://app.cloudback.it/api/ops/

Usage

Provider Configuration

terraform {
  required_providers {
    cloudback = {
      source = "cloudback/cloudback"
    }
  }
}

provider "cloudback" {
  api_key = "your-api-key" # Replace with your API key, see https://app.cloudback.it/apikeys
}

Note: You can provide your API key either directly in the configuration or through the CLOUDBACK_API_KEY environment variable:

export CLOUDBACK_API_KEY="your-api-key"

Resource: Backup Definition

Backup definitions are the primary resources managed by the Cloudback. They represent the configuration for a specific repository.

resource "cloudback_backup_definition" "demo" {
  platform = "GitHub"
  account = "cloudback"
  repository = "demo-repository"
  settings = {
    enabled = true
    schedule = "Daily at 9 pm"
    storage = "Cloudback EU"
    retention = "Last 30 days"
  }
}

Attributes:

  • platform: The platform of the repository (e.g., GitHub, GitLab, Bitbucket). Mandatory.

  • account: The account name of the repository. Mandatory.

  • repository: The repository name. Mandatory.

  • settings: The backup configuration settings. Mandatory.

    • enabled: Whether the automated scheduled backup is enabled, true or false. Optional.

    • retention: The retention policy for the backup. Possible options are Last 30 days, Last 90 days, Last 180 days, Last 360 days. Optional.

Documentation

References

schedule: The schedule for the automated backup. Complete list of supported schedules can be found . Optional.

storage: The storage location for the backup. Complete list of supported storages can be found . Optional.

For detailed documentation and examples, visit the .

Terraform
Operations API
API Keys
here
here
official repository
GitHub Repository
Terraform Registry
Cloudback Operations API
Terraform Documentation