Terraform Language Server

The official Terraform language server (terraform-ls) maintained by HashiCorp provides IDE features to any LSP-compatible editor.

Current Status

Not all language features (from LSP's or any other perspective) are available at the time of writing, but this is an active project with the aim of delivering smaller, incremental updates over time. You can review the LSP feature matrix.

We encourage you to browse existing issues and/or open new issue if you experience a bug or have an idea for a feature.

Stability

We aim to communicate our intentions regarding breaking changes via semver. Relatedly we may use pre-releases, such as MAJOR.MINOR.PATCH-beta1 to gather early feedback on certain features and changes.

We ask that you report any bugs in any versions but especially in pre-releases, if you decide to use them.

Installation

Some editors have built-in logic to install and update the language server automatically, so you may not need to worry about installation or updating of the server.

Read the installation page for installation instructions.

Usage

The most reasonable way you will interact with the language server is through a client represented by an IDE, or a plugin of an IDE.

Please follow the relevant guide for your IDE.

Contributing

Please refer to .github/CONTRIBUTING.md for more information on how to contribute to this project.

Credits

• Martin Atkins - particularly the virtual filesystem
• Zhe Cheng - research, design, prototyping assistance
• Julio Sueiras - particularly his language server implementation

Telemetry

The server will collect data only if the client requests it during initialization. Telemetry is opt-in by default.

Read more about telemetry.