Skip to content

[update] Use Terraform to Provision Infrastructure on Linode #7443

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Rajakavitha1 wants to merge 3 commits into
base: develop
Choose a base branch
from
+24 −20
Open

[update] Use Terraform to Provision Infrastructure on Linode #7443

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
58184fc
Update index.md
Rajakavitha1 Apr 13, 2026
511ebb4
Update index.md
Rajakavitha1 Apr 14, 2026
3b2cc29
Update index.md
Rajakavitha1 Apr 14, 2026
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
44 changes: 24 additions & 20 deletions .../terraform/how-to-build-your-infrastructure-using-terraform-and-linode/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,12 @@ The configurations and commands used in this guide results in multiple Linodes b

## Before You Begin

{{< note title ="Linode Provider Version 3.0.0" >}}
As of June, 2025, the [Linode Terraform Provider](https://github.com/linode/terraform-provider-linode/) version is 3.0.0. To determine the current version, see the [Linode Namespace](https://registry.terraform.io/namespaces/linode) in the Terraform Registry.
{{< note title ="Linode Provider Version 3.11.0" >}}
As of April, 2026, the [Linode Terraform Provider](https://github.com/linode/terraform-provider-linode/) version is 3.11.0. To determine the current version, see the [Linode Namespace](https://registry.terraform.io/namespaces/linode) in the Terraform Registry.

The Linode Terraform Provider version 3.0.0 requires `terraform` version 1.0 or greater. See [Terraform's developer documentation](https://developer.hashicorp.com/terraform/language/v1.1.x/upgrade-guides/1-0) for guidance on upgrading to version 1.0.
The Linode Terraform Provider version 3.11.0 requires `terraform` version 1.0 or greater. See [Terraform's developer documentation](https://developer.hashicorp.com/terraform/language/v1.1.x/upgrade-guides/1-0) for guidance on upgrading to version 1.0.

The examples in this guide were originally written to be compatible with [Terraform version 0.11](https://www.terraform.io/docs/configuration-0-11/terraform.html).
The examples in this guide were originally written to be compatible with [Terraform version 0.11](https://developer.hashicorp.com/terraform/language/configuration-0-11/terraform).
{{< /note >}}

- This guide shows you how to install and use the Terraform client software from a Linux system. Terraform can be installed on other operating systems, and the instructions for those platforms are analogous to the commands presented in this guide.
Expand Down Expand Up @@ -124,7 +124,7 @@ Terraform uses a declarative approach in which configuration files specify the d
required_providers {
linode = {
source = "linode/linode"
version = "3.0.0"
version = "3.11.0"
}
}
}
Expand Down Expand Up @@ -161,9 +161,9 @@ Terraform uses a declarative approach in which configuration files specify the d
```output
Initializing the backend...
Initializing provider plugins...
- Finding linode/linode versions matching "3.0.0"...
- Installing linode/linode v3.0.0...
- Installed linode/linode v3.0.0 (signed by a HashiCorp partner, key ID F4E6BBD0EA4FE463)
- Finding linode/linode versions matching "3.11.0"...
- Installing linode/linode v3.11.0...
- Installed linode/linode v3.11.0 (signed by a HashiCorp partner, key ID F4E6BBD0EA4FE463)
Partner and community providers are signed by their developers.
If you'd like to know more about provider signing, you can read about it here:
https://developer.hashicorp.com/terraform/cli/plugins/signing
Expand All @@ -183,7 +183,7 @@ Terraform uses a declarative approach in which configuration files specify the d
```
{{< /note >}}

1. Run Terraform's [plan](https://www.terraform.io/docs/commands/plan.html) command:
1. Run Terraform's [plan](https://developer.hashicorp.com/terraform/cli/commands/plan) command:

```command
terraform plan
Expand Down Expand Up @@ -211,7 +211,7 @@ Terraform uses a declarative approach in which configuration files specify the d
backups.#: <computed>
backups_enabled: <computed>
boot_config_label: <computed>
group: "Terraform"
tags: "Terraform"
image: "linode/ubuntu24.04"
ip_address: <computed>
ipv4.#: <computed>
Expand Down Expand Up @@ -268,7 +268,7 @@ Terraform uses a declarative approach in which configuration files specify the d
backups.#: "" => "<computed>"
backups_enabled: "" => "<computed>"
boot_config_label: "" => "<computed>"
group: "" => "Terraform"
tags: "" => "Terraform"
image: "" => "linode/ubuntu24.04"
ip_address: "" => "<computed>"
ipv4.#: "" => "<computed>"
Expand Down Expand Up @@ -308,7 +308,7 @@ In production environments, your SSH key and root password should be unique for

```file {title="~/terraform/linode-terraform-db.tf"}
resource "linode_instance" "terraform-db" {
image = "linode/centos7"
image = "linode/ubuntu24.04"
label = "Terraform-Db-Example"
group = "Terraform"
region = "us-south"
Expand Down Expand Up @@ -434,7 +434,7 @@ To solve these issues, Terraform allows you to declare variables and insert thos
required_providers {
linode = {
source = "linode/linode"
version = "3.0.0"
version = "3.11.0"
}
}
}
Expand All @@ -445,9 +445,9 @@ To solve these issues, Terraform allows you to declare variables and insert thos

# Example Web Server
resource "linode_instance" "terraform-web" {
image = "linode/centos7"
image = "linode/ubuntu24.04"
label = "Terraform-Web-Example"
group = "Terraform"
tags = "Terraform"
region = var.region
type = "g6-standard-1"
swap_size = 1024
Expand All @@ -459,7 +459,7 @@ To solve these issues, Terraform allows you to declare variables and insert thos
resource "linode_instance" "terraform-db" {
image = "linode/ubuntu24.04"
label = "Terraform-Db-Example"
group = "Terraform"
tags = "Terraform"
region = var.region
type = "g6-standard-1"
swap_size = 1024
Expand Down Expand Up @@ -561,7 +561,7 @@ The module structure is flexible, so you can use as many Terraform files as need
resource "linode_instance" "terraform-web" {
image = "linode/ubuntu24.04"
label = var.webserver_label
group = "Terraform"
tags = "Terraform"
region = var.region
type = "g6-standard-1"
swap_size = 1024
Expand All @@ -573,7 +573,7 @@ The module structure is flexible, so you can use as many Terraform files as need
resource "linode_instance" "terraform-db" {
image = "linode/centos7"
label = var.dbserver_label
group = "Terraform"
tags = "Terraform"
region = var.region
type = var.db_type
swap_size = 1024
Expand Down Expand Up @@ -637,7 +637,7 @@ Create a deployment for an imaginary client:
required_providers {
linode = {
source = "linode/linode"
version = "3.0.0"
version = "3.11.0"
}
}
}
Expand Down Expand Up @@ -685,6 +685,9 @@ Create a deployment for an imaginary client:
[State](https://developer.hashicorp.com/terraform/language/state) data files are stored on a [backend](https://developer.hashicorp.com/terraform/language/settings/backends/configuration) by Terraform to log and track metadata, map resources to a configuration, and improve performance. By default, state is stored locally in the `terraform.tfstate` file.

Using the configuration below with the `backend` block, you can set up Terraform to use Linode Object Storage to store state remotely. The `backend` block should be nested within the `terraform` block as noted in [Hashicorp's official backend documentation](https://developer.hashicorp.com/terraform/language/settings/backends/s3). In this guide, the `terraform` block is located in the `main.tf` configuration file.
{{< note >}}
HashiCorp only tests the S3 backend against Amazon S3 and offers support for S3-compatible providers on a best-effort basis only.
{{< /note >}}

Note that this module assumes an object storage bucket already exists on your account. Replace values with your bucket and key information:

Expand All @@ -700,8 +703,9 @@ backend "s3" {
skip_credentials_validation = true
skip_requesting_account_id = true
skip_s3_checksum = true
use_path_style = true #required for non-AWS endpoints
endpoints = {
s3 = "{{< placeholder "https://us-southeast-1.linodeobjects.com" >}}" # The endpoint for the s3 API based on the region your bucket is located https://techdocs.akamai.com/cloud-computing/docs/access-buckets-and-files-through-urls#cluster-url-s3-endpoint
}
}
```
```
Loading