Ferron mock DNS provider
July 29, 2025 ยท View on GitHub
This is a mock DNS provider for Ferron, demonstrating how to create a custom DNS provider for ACME with Ferron.
Example directive specification
auto_tls_challenge "dns-01" provider="mock"
Additional props
None
Compiling Ferron with this provider
To compile Ferron with this provider, first clone the Ferron repository:
git clone https://github.com/ferronweb/ferron.git -b develop-2.x
cd ferron
Then, copy the ferron-build.yaml file to ferron-build-override.yaml:
cp ferron-build.yaml ferron-build-override.yaml
After that, add the following line to the ferron-build-override.yaml file:
dns:
# Other DNS providers...
- git: https://github.com/ferronweb/ferron-dns-mock.git
id: mock
crate: ferron-dns-mock
provider: MockDnsProvider
After modifying the ferron-build-override.yaml file, you can compile Ferron with this module by running the following command:
make build
Or if you're on Windows:
powershell -ExecutionPolicy Bypass .\build.ps1 Build
You can then package it in a ZIP archive using the following command:
make package
Or if you're on Windows:
powershell -ExecutionPolicy Bypass .\build.ps1 Package
The ZIP archive will be created in the dist directory, and can be installed using Ferron installer.