Struct AcmeConfig 

pub struct AcmeConfig {
    pub email: String,
    pub domains: Vec<String>,
    pub staging: bool,
    pub storage: PathBuf,
    pub renew_before_days: u32,
    pub challenge_type: AcmeChallengeType,
    pub dns_provider: Option<DnsProviderConfig>,
}

ACME automatic certificate configuration

Enables zero-config TLS via Let’s Encrypt and compatible CAs. When configured, Grapsus will automatically obtain, renew, and manage TLS certificates for the specified domains.

Example

tls {
    acme {
        email "admin@example.com"
        domains "example.com" "www.example.com"
        staging false
        storage "/var/lib/grapsus/acme"
        renew-before-days 30
        challenge-type "http-01"  // or "dns-01" for wildcards

        // Required for DNS-01 challenges
        dns-provider {
            type "hetzner"
            credentials-file "/etc/grapsus/secrets/hetzner-dns.json"
            api-timeout-secs 30

            propagation {
                initial-delay-secs 10
                check-interval-secs 5
                timeout-secs 120
            }
        }
    }
}

Fields

email: String

Contact email for Let’s Encrypt account Required for account registration and recovery

domains: Vec<String>

Domain names to obtain certificates for At least one domain is required

staging: bool

Use Let’s Encrypt staging environment Set to true for testing to avoid rate limits

storage: PathBuf

Directory for storing certificates and account keys Defaults to /var/lib/grapsus/acme

renew_before_days: u32

Days before expiry to trigger renewal Let’s Encrypt certificates are valid for 90 days Default is 30 days before expiry

challenge_type: AcmeChallengeType

Challenge type to use for domain validation Defaults to HTTP-01, use DNS-01 for wildcard certificates

dns_provider: Option<DnsProviderConfig>

DNS provider configuration (required for DNS-01 challenges)

Trait Implementations

impl Clone for AcmeConfig

fn clone(&self) -> AcmeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AcmeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AcmeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AcmeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Validate for AcmeConfig

fn validate(&self) -> Result<(), ValidationErrors>

impl<'v_a> ValidateArgs<'v_a> for AcmeConfig

type Args = ()

fn validate_with_args(&self, args: Self::Args) -> Result<(), ValidationErrors>