opentofu

OpenTofu

OpenTofu is an open-source infrastructure as code tool that lets you define, provision, and manage cloud and on-premises resources declaratively.
This stack runs the official OpenTofu container image for executing Terraform/OpenTofu configurations.

How it works

flowchart LR
    Dev([Developer]) -->|tofu plan/apply| Tofu[OpenTofu Container]
    Config[(./config/*.tf)] -->|mounted at /workspace| Tofu
    Tofu --> State[(./config/*.tfstate)]
    Tofu --> Cloud[AWS / GCP / Azure / ...]

Loading

sequenceDiagram
    participant Dev as Developer
    participant Tofu as OpenTofu Container
    participant Vol as ./config (Volume)
    participant Cloud as Cloud Provider

    Dev->>Vol: Write *.tf files
    Dev->>Tofu: docker compose exec tofu init
    Tofu->>Vol: Read config
    Tofu->>Cloud: Initialize providers
    Cloud-->>Tofu: Provider ready

    Dev->>Tofu: docker compose exec tofu plan
    Tofu->>Cloud: Query current state
    Cloud-->>Tofu: Resources
    Tofu-->>Dev: Plan output

    Dev->>Tofu: docker compose exec tofu apply
    Tofu->>Cloud: Create/update resources
    Cloud-->>Tofu: Resource IDs
    Tofu->>Vol: Write .tfstate
    Tofu-->>Dev: Apply complete

    Dev->>Tofu: docker compose exec tofu destroy
    Tofu->>Cloud: Delete resources
    Cloud-->>Tofu: Resources deleted
    Tofu->>Vol: Update .tfstate

Loading

1. Place your *.tf configuration files in config/.
2. Run OpenTofu commands via docker compose exec.
3. OpenTofu executes inside the container using the mounted workspace.
4. State files are written back to config/ for persistence.
5. Providers provision real infrastructure in your cloud targets.

Stack details in this repo

• Image: ghcr.io/opentofu/opentofu:minimal
• Working directory inside container: /workspace
• Persistent data:
  • ./config/ — maps to /workspace (your .tf files and state)

How to run

From the repository root:

cd opentofu
docker compose up -d

Useful commands:

docker compose exec opentofu tofu init
docker compose exec opentofu tofu plan
docker compose exec opentofu tofu apply
docker compose exec opentofu tofu destroy
docker compose logs -f
docker compose down

Notes

• Place your *.tf configuration files in the config/ directory.
• State files will be stored in config/ as well.
• For multi-environment workflows, create subdirectories inside config/ (e.g., config/dev/, config/prod/).