Quickstart
Get up to speed with Tharsis quickly! We recommend starting with the video demo below to see Tharsis in action, then follow the hands-on guide to create your first group, workspace, and run.
Tharsis on YouTube​
Watch this quick intro and demo to see Tharsis in action:
Getting Started with Tharsis: An Open Source, DevOps Platform for Terraform
This demo shows launching an EC2 instance with Tharsis, highlighting key features like plan visualization, drift detection, and the benefits of using Tharsis for your Terraform workflows.
Prerequisites​
- A running Tharsis instance (see Docker setup for the quickest option)
- Tharsis CLI installed and configured
After installing the CLI, configure it to point to your Tharsis instance and log in:
tharsis configure
tharsis sso login
Create a group and workspace​
Create a subgroup
tharsis group create <parent-group>/<subgroup>
Create a workspace
tharsis workspace create <parent-group>/<subgroup>/<workspace>
note
If you don't have a top-level group, ask a system administrator to create one for you.
Apply a sample Terraform module​
Create a new directory and save the following as module.tf:
Sample Terraform Module using null resource
# Simulate creating a resource which takes a minute.
resource "time_sleep" "wait_60_seconds" {
create_duration = "60s"
}
resource "null_resource" "next" {
depends_on = [time_sleep.wait_60_seconds]
}
Apply the Terraform module
tharsis apply -directory-path "/path/to/directory/containing/module/file" <parent-group>/<subgroup>/<workspace>