Salt acme.sh Formula

Interacts with acme.sh:

• install acme.sh
• issue certificates
• renew certificates

The following modes are supported:

• standalone
• webroot
• dns

General notes

See the full SaltStack Formulas installation and usage instructions.

See example.yml on how to configure the formula.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

Available states

• acme.sh
• acme.sh.install
• acme.sh.issue

acme.sh

Includes the following states:

• acme.sh.install
• acme.sh.issue

acme.sh.install

Installs acme.sh.

acme.sh.issue

Issues or renews certificate with acme.sh.

Available execution modules

• acme.sh

Available state modules

• acme.sh

Testing

Linux testing is done with kitchen-salt.

All tests and lint jobs are executed in GitHub Actions.

Requirements

You can test the formula locally after installing the following requirements.

• vagrant
• VirtualBox
• Ruby
• bundler

Run Test

bundle install
kitchen list # list all available test instances
kitchen test <instance>

OS support matrix

This formula has been tested under the following operating systems and salt versions.

OS	3006.0	3006.5
Debian 12	❌	✅
Ubuntu 22.04	❌	✅
Rocky 9	❌	✅
Fedora 38	❌	✅
OpenSUSE 15	✅	Not released