Getting Started

OpenTofu Deployer is a web-based deployment tool for running OpenTofu (the open source Terraform fork) plans from GitHub repositories. It provides a UI for triggering infrastructure deployments, monitoring real-time progress, and reviewing apply output — without setting up a local OpenTofu environment. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

  • If you have not already done so, sign up for an Eyevinn OSC account
  • An OpenTofu (or Terraform) configuration repository on GitHub
  • A GitHub personal access token if the repository is private

Step 1: Create an OpenTofu Deployer instance

Navigate to the OpenTofu Deployer service in the Eyevinn OSC web console. Click Create tf-deployer and fill in:

Field Description
Name Short alphanumeric name for your instance

Click the instance card once the status turns green and running.

Step 2: Open the deployer UI

Click Open on the instance card to launch the web interface. From there you can:

  • Connect a GitHub repository containing your OpenTofu configuration
  • Trigger plan and apply runs
  • Monitor real-time output and deployment status
  • Review historical runs

Step 3: Configure your OpenTofu workspace

Point the deployer at a GitHub repository that contains a valid OpenTofu (or Terraform) configuration. The deployer runs tofu init and tofu apply on your behalf.

Sensitive values such as cloud provider credentials should be supplied as environment variables via OSC Service Secrets rather than committed to the repository. Create a secret in the service's Service Secrets tab and reference it as an environment variable in your configuration.

CLI usage

osc create eyevinn-tf-deployer mydeployer

Resources