Skip to main content

A Pulumi package for creating and managing consul resources.

Project description

Actions Status Slack NPM version Python version NuGet version PkgGoDev License

Hashicorp Consul Resource Provider

The Consul resource provider for Pulumi lets you manage Consul resources in your cloud programs. To use this package, please install the Pulumi CLI first.


This package is available in many languages in the standard packaging formats.

Node.js (Java/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

$ npm install @pulumi/consul

or yarn:

$ yarn add @pulumi/consul


To use from Python, install using pip:

$ pip install pulumi_consul


To use from Go, use go get to grab the latest version of the library

$ go get


To use from .NET, install using dotnet add package:

$ dotnet add package Pulumi.Consul


The following configuration points are available:

  • consul:address - (Optional) The HTTP(S) API address of the agent to use. Defaults to
  • consul:scheme - (Optional) The URL scheme of the agent to use (http or https). Defaults to http.
  • consul:httpAuth - (Optional) HTTP Basic Authentication credentials to be used when communicating with Consul, in the format of either user or user:pass. This may also be specified using the CONSUL_HTTP_AUTH environment variable.
  • consul:datacenter - (Optional) The datacenter to use. Defaults to that of the agent.
  • consul:token - (Optional) The ACL token to use by default when making requests to the agent. Can also be specified with CONSUL_HTTP_TOKEN or CONSUL_TOKEN as an environment variable.
  • consul:caFile - (Optional) A path to a PEM-encoded certificate authority used to verify the remote agent's certificate.
  • consul:certFile - (Optional) A path to a PEM-encoded certificate provided to the remote agent; requires use of keyFile.
  • consul:keyFile - (Optional) A path to a PEM-encoded private key, required if certFile is specified.
  • consul:caPath - (Optional) A path to a directory of PEM-encoded certificate authority files to use to check the authenticity of client and server connections. Can also be specified with the CONSUL_CAPATH environment variable.
  • consul:insecureHttps - (Optional) Boolean value to disable SSL certificate verification; setting this value to true is not recommended for production use. Only use this with scheme set to https.


For further information, please visit the Consul provider docs or for detailed reference documentation, please visit the API docs.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pulumi_consul-3.11.3.tar.gz (122.9 kB view hashes)

Uploaded Source

Built Distribution

pulumi_consul-3.11.3-py3-none-any.whl (188.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page