terraform-provider-acme

Terraform ACME Provider
========================

> [!NOTE]
> This is a maintained fork of the vancluever/acme provider.
> This fork is actively maintained to provide critical enhancements and features
> that are currently missing or unaddressed in the upstream repository.
>
> Key Enhancements:
>
> - Resource-Level server_url (see
> Issue #534
> or the feat/resource-level-server-url
> branch):
> Added the ability to specify the ACME server_url directly on resources
> (acme_certificate and acme_registration). This allows overriding the
> provider-level URL, preventing legacy module restrictions when managing
> resources across multiple ACME endpoints.
> - Insecure Recreate (see the
> feat/certificate-insecure-recreate
> branch):
> Added the insecure_recreate flag to the acme_certificate resource. This
> enables automatic recreation of the certificate if the associated ACME
> account (registration) is missing or deleted on the server. This is
> critical for local testing with stateless ACME servers (like Pebble)
> that do not persist state across restarts.

This is the repository for the Terraform ACME Provider, which one can use with
Terraform to manage and generate certificates generated by an [ACME][about-acme]
CA, such as [Let's Encrypt][lets-encrypt].

[about-acme]: https://ietf-wg-acme.github.io/acme/draft-ietf-acme-acme.html
[lets-encrypt]: https://letsencrypt.org

For general information about Terraform, visit the [official
website][terraform-io] and the [GitHub project page][terraform-gh].

[terraform-io]: https://www.terraform.io/
[terraform-gh]: https://github.com/hashicorp/terraform

:warning: NOTE: The ACME provider found here supports ACME v2 only.

Documentation

Documentation for this provider can be found at
https://registry.terraform.io/providers/vancluever/acme/latest/docs.

Contributing

Note that public pull requests to this repository are closed. See
CONTRIBUTING.md for more details.

License

Copyright 2018-2026 Chris Marchesi
Copyright 2016-2018 PayByPhone Technologies, Inc.
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.
---
This project uses code and documentation from the lego project
(https://go-acme.github.io/lego/), used under the terms of the MIT license. The
following is the text of the MIT license.
The MIT License (MIT)
Copyright (c) 2017-2024 Ludovic Fernandez
Copyright (c) 2015-2017 Sebastian Erhart
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.