Skip to content
Open
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
bb374bf
Added information on OpenTofu support in addition to Terraform
maximmasiutin Sep 26, 2025
7c657c2
Added information on OpenTofu support in addition to Terraform and fi…
maximmasiutin Sep 26, 2025
468bd77
Merge branch 'runatlantis:main' into main
maximmasiutin Sep 27, 2025
17de943
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 1, 2025
88e216e
Merge branch 'main' into main
chenrui333 Oct 8, 2025
351dfe9
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 11, 2025
e6ae1d5
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 15, 2025
feb6e77
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 17, 2025
f1e2e54
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 19, 2025
f204d75
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 21, 2025
dfeab36
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 23, 2025
0fc988c
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 25, 2025
4b1e9bb
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 29, 2025
5a73c5f
Merge branch 'runatlantis:main' into main
maximmasiutin Oct 30, 2025
418c99b
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 2, 2025
226a9ef
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 5, 2025
ae70529
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 8, 2025
bd31753
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 13, 2025
8e97306
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 14, 2025
2072ce7
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 20, 2025
3f716df
Merge branch 'runatlantis:main' into main
maximmasiutin Nov 27, 2025
c4aef95
Merge branch 'runatlantis:main' into main
maximmasiutin Dec 4, 2025
91bae53
Merge branch 'runatlantis:main' into main
maximmasiutin Dec 7, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 16 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

<p align="center">
<img src="./runatlantis.io/public/hero.png" alt="Atlantis Logo"/><br><br>
<b>Terraform Pull Request Automation</b>
<b>Terraform & OpenTofu Pull Request Automation</b>
</p>

- [Resources](#resources)
Expand All @@ -20,22 +20,27 @@
- [Stargazers over time](#stargazers-over-time)

## Resources
* How to get started: [www.runatlantis.io/guide](https://www.runatlantis.io/guide)
* Full documentation: [www.runatlantis.io/docs](https://www.runatlantis.io/docs)
* Download the latest release: [github.com/runatlantis/atlantis/releases/latest](https://github.com/runatlantis/atlantis/releases/latest)
* Get help in our [Slack channel](https://slack.cncf.io/) in channel #atlantis and development in #atlantis-contributors
* Start Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)

- How to get started: [www.runatlantis.io/guide](https://www.runatlantis.io/guide)
- Full documentation: [www.runatlantis.io/docs](https://www.runatlantis.io/docs)
- Download the latest release: [github.com/runatlantis/atlantis/releases/latest](https://github.com/runatlantis/atlantis/releases/latest)
- Get help in our [Slack channel](https://slack.cncf.io/) in channel #atlantis and development in #atlantis-contributors
- Start Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)

## What is Atlantis?
A self-hosted golang application that listens for Terraform pull request events via webhooks.

A self-hosted Go application that listens for Terraform and OpenTofu pull request events via webhooks.

## What does it do?
Runs `terraform plan`, `import`, `apply` remotely and comments back on the pull request with the output.

Runs `terraform plan`, `import`, `apply` (or `tofu plan`, `import`, `apply`) remotely and comments back on the pull request with the output.

## Why should you use it?
* Make Terraform changes visible to your whole team.
* Enable non-operations engineers to collaborate on Terraform.
* Standardize your Terraform workflows.

- Make Terraform and OpenTofu changes visible to your whole team.
- Enable non-operations engineers to collaborate on infrastructure as code.
- Standardize your Terraform and OpenTofu workflows.
- Support both Terraform and OpenTofu in the same instance.

## Stargazers over time

Expand Down
20 changes: 18 additions & 2 deletions runatlantis.io/docs/repo-level-atlantis-yaml.md
Original file line number Diff line number Diff line change
Expand Up @@ -273,12 +273,28 @@ by the `--default-tf-version` flag, then set the `terraform_distribution` key:
```yaml
version: 3
projects:
- dir: project1
terraform_distribution: opentofu
- dir: project1
terraform_distribution: opentofu
- dir: project2
terraform_distribution: terraform
```

Atlantis will automatically download and use this distribution. Valid values are `terraform` and `opentofu`.

When using OpenTofu, you can also specify a specific version:

```yaml
version: 3
projects:
- dir: opentofu-project
terraform_distribution: opentofu
terraform_version: 1.9.0
```

:::tip OpenTofu Migration
If you're migrating from Terraform to OpenTofu, you can run both in the same Atlantis instance by specifying different distributions per project. This allows for gradual migration.
:::

### Terraform Versions

If you'd like to use a different version of Terraform than what is in Atlantis'
Expand Down