Use OpenTofu as Docker Image
OpenTofu is available as OCI container images, and distributed via public GitHub Packages registry.
Versions
Images are hosted as packages in the OpenTofu GitHub organization. See the list of available versions here.
The multi platform images are available using the following tags:
latest: latest overall version of OpenTofu,Major: a specific major version of OpenTofu,Major.Minor: a specific minor version of OpenTofu,Major.Minor.Patch: a specific patch version of OpenTofu.
To pull platform-specific images (amd64, arm, arm64, 386) use:
<Version>-<Platform>: a platform specific version of OpenTofu.
Usage
Note
If you run into rate limiting issues with GitHub, create a Personal Access Token and log in to the registry.
Note
In the examples below you should have at least one .tf file located in the folder you are running the docker command.
To pull the image from GitHub Packages registry:
docker pull ghcr.io/opentofu/opentofu:latest
To run OpenTofu as a Docker container:
# Init providers plugins
docker run \
--workdir=/srv/workspace \
--mount type=bind,source=.,target=/srv/workspace \
ghcr.io/opentofu/opentofu:latest \
init
# Creating plan file
docker run \
--workdir=/srv/workspace \
--mount type=bind,source=.,target=/srv/workspace \
ghcr.io/opentofu/opentofu:latest \
plan -out=main.plan
# Applying plan file
docker run \
--workdir=/srv/workspace \
--mount type=bind,source=.,target=/srv/workspace \
ghcr.io/opentofu/opentofu:latest \
apply "/srv/workspace/main.plan"