PHPackages pantheon-systems/terminus-acme-plugin - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. pantheon-systems/terminus-acme-plugin AbandonedArchivedTerminus-plugin[Utility & Helpers](/categories/utility) pantheon-systems/terminus-acme-plugin ===================================== Terminus commands to interact with ACME challenges. 2.0.0(4y ago)83592[1 issues](https://github.com/pantheon-systems/terminus-acme-plugin/issues)MITPHP Since Jul 16Pushed 1y ago49 watchersCompare [ Source](https://github.com/pantheon-systems/terminus-acme-plugin)[ Packagist](https://packagist.org/packages/pantheon-systems/terminus-acme-plugin)[ RSS](/packages/pantheon-systems-terminus-acme-plugin/feed)WikiDiscussions 2.x Synced 1mo ago READMEChangelogDependenciesVersions (8)Used By (0) Terminus ACME Plugin ==================== [](#terminus-acme-plugin) [![Deprecated](https://camo.githubusercontent.com/19ce980e24846b0433e0a167f429d6824cfb00eebce15cd1f657a8cba03ba2e1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50616e7468656f6e2d446570726563617465642d79656c6c6f773f6c6f676f3d70616e7468656f6e26636f6c6f723d464644433238)](https://pantheon.io/docs/oss-support-levels#deprecated) [![Terminus v1.x Compatible](https://camo.githubusercontent.com/9ea8fb0893368c0b24f172cc2df676fa4bb7246d14c0377b7924a6918065be26/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d76312e782d677265656e2e737667)](https://github.com/pantheon-systems/terminus)[![Terminus v2.x Compatible](https://camo.githubusercontent.com/4cf69d5d2946c607d2f77591c24ad1f265f4d8d0b492255a97a7e5a03730aa7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d76322e782d677265656e2e737667)](https://github.com/pantheon-systems/terminus) Terminus commands to interact with ACME domain ownership validation challenges. You can use these commands to allow Pantheon to obtain an HTTPS certificate for your domain before you go live on Pantheon. Configuration ------------- [](#configuration) These commands require no configuration. Usage ----- [](#usage) ### 1. Obtain an ACME challenge to prove domain ownership [](#1-obtain-an-acme-challenge-to-prove-domain-ownership) Choose to provision a DNS txt record or to serve a file from your existing webserver to prove you own the domain. #### Using a DNS TXT record: [](#using-a-dns-txt-record) - `terminus alpha:https:challenge:dns-txt . example.com` ``` [notice] Create a DNS txt record containing: _acme-challenge.example.com. 300 IN TXT "CHALLENGE_TEXT" [notice] After this is complete, run terminus acme-txt-verify . example.com ``` This command also supports the `--format` and `--fields` options to assist in automating your workflows with Terminus. #### Using a file on your existing webserver: [](#using-a-file-on-your-existing-webserver) - `terminus alpha:https:challenge:file . example.com` ``` [notice] Wrote ACME challenge to file hult7KCSkUm1SpdaVlh28JhJ9f3J6U6Kv7H-QH3i-0Y [notice] Please copy this file to your web server so that it will be served from the URL [notice] http://example.com/.well-known/acme-challenge/hult7KCSkUm1SpdaVlh28JhJ9f3J6U6Kv7H-QH3i-0Y [notice] After this is complete, run terminus acme-file-verify . example.com ``` You must be a member of the site's team to create challenges. ### 2. Tell Pantheon the challenge is ready to be verified [](#2-tell-pantheon-the-challenge-is-ready-to-be-verified) After you have deployed the ACME challenge, tell Pantheon the challenge is ready to be verified using the appropriate command below. #### Using a DNS TXT record: [](#using-a-dns-txt-record-1) - `terminus acme-txt-verify . example.com` ``` [notice] The challenge for example.com is being verified... [notice] Ownership verification is complete! [notice] Your HTTPS certificate will be deployed to Pantheon's Global CDN shortly. ``` #### Using a file on your existing webserver: [](#using-a-file-on-your-existing-webserver-1) - `terminus alpha:https:challenge:file:verify . example.com` ``` [notice] The challenge for example.com is being verified... [notice] Ownership verification is complete! [notice] Your HTTPS certificate will be deployed to Pantheon's Global CDN shortly. ``` For those scripting automation with this plugin, note: - The verify commands exit 0 if verification was successful or nonzero if there was an error. - When a verification error occurs, it is sometimes necessary to serve a new challenge. Your automation should call the command to obtain the challenge again and see if it has changed. Installation ------------ [](#installation) To install this plugin place it in `~/.terminus/plugins/`. On Mac OS/Linux: ``` mkdir -p ~/.terminus/plugins curl https://github.com/pantheon-systems/terminus-acme-plugin/archive/2.0.0-alpha1.tar.gz -L | tar -C ~/.terminus/plugins -xvz ``` Help ---- [](#help) Run `terminus help alpha:https:challenge:dns-txt` for help. ### Health Score 36 — LowBetter than 82% of packages Maintenance24 Infrequent updates — may be unmaintained Popularity23 Limited adoption so far Community20 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 50% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~332 days Total 5 Last Release 1524d ago Major Versions 0.1.0 → 1.x-dev2019-06-05 1.x-dev → 2.0.0-alpha12020-06-05 ### Community Maintainers ![](https://www.gravatar.com/avatar/b34cc6bd882277b6c6dda19bf6631ae5c3a909fd667c826a15121642cdc051b2?d=identicon)[greg.1.anderson](/maintainers/greg.1.anderson) ![](https://www.gravatar.com/avatar/5a89f5f15357797cbd6ec7833a28626478ae3c0ceb5fa1faa8a26d0960584c65?d=identicon)[pantheon-systems](/maintainers/pantheon-systems) --- Top Contributors [![greg-1-anderson](https://avatars.githubusercontent.com/u/612191?v=4)](https://github.com/greg-1-anderson "greg-1-anderson (10 commits)")[![mbaynton](https://avatars.githubusercontent.com/u/3026002?v=4)](https://github.com/mbaynton "mbaynton (5 commits)")[![jslang](https://avatars.githubusercontent.com/u/107465?v=4)](https://github.com/jslang "jslang (3 commits)")[![kporras07](https://avatars.githubusercontent.com/u/2217820?v=4)](https://github.com/kporras07 "kporras07 (2 commits)") ### Embed Badge ![Health badge](/badges/pantheon-systems-terminus-acme-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/pantheon-systems-terminus-acme-plugin/health.svg)](https://phpackages.com/packages/pantheon-systems-terminus-acme-plugin) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)