In April 2024, the Core Atlantis Team launched an anonymous survey to better understand our community's needs and help prioritize our roadmap.
If you're an Atlantis user, please take 5 minutes to fill it out: Survey Link
In April 2024, the Core Atlantis Team launched an anonymous survey to better understand our community's needs and help prioritize our roadmap.
If you're an Atlantis user, please take 5 minutes to fill it out: Survey Link
Atlantis works with most Git hosts and Terraform setups. Read on to confirm it works with yours.
Atlantis integrates with the following Git hosts:
Atlantis supports all backend types except for local state. We don't support local state because Atlantis does not have permanent storage and it doesn't commit the new statefile back to version control.
TIP
If you're looking for an easy remote state solution, check out free remote state storage from Terraform Cloud. This is fully supported by Atlantis.
Atlantis supports any Terraform repository structure, for example:
.
├── main.tf
└── ...
.
├── project1
│ ├── main.tf
| └── ...
└── project2
├── main.tf
└── ...
.
├── project1
│ ├── main.tf
| └── ...
└── modules
└── module1
├── main.tf
└── ...
With modules, if you want project1
automatically planned when module1
is modified you need to create an atlantis.yaml
file. See atlantis.yaml Use Cases for more details.
See Terraform's docs if you are unfamiliar with workspaces.
If you're using Terraform >= 0.9.0
, Atlantis supports workspaces through an atlantis.yaml
file that tells Atlantis the names of your workspaces (see atlantis.yaml Use Cases for more details)
.
├── production.tfvars
│── staging.tfvars
└── main.tf
For Atlantis to be able to plan automatically with .tfvars files
, you need to create an atlantis.yaml
file to tell it to use -var-file={YOUR_FILE}
. See atlantis.yaml Use Cases for more details.
Atlantis supports multiple repos as well–as long as there is a webhook configured for each repo.
Atlantis supports all Terraform versions (including 0.12) and can be configured to use different versions for different repositories/projects. See Terraform Versions.