# Reference: server.acme

URL: https://scalws.com/docs/reference/server-acme/
Source: `docs/reference/schema` in the ScalWS repository

<h3 id="server.acme.ca_bundle"><code>server.acme.ca_bundle</code></h3>

| | |
|---|---|
| Syntax | `ca_bundle: <string>` |
| Default | `none` |
| Context | `server.acme` |
| Reload | applies on reload |

Extra root certificate (PEM) trusted for the ACME directory (test CAs).


<h3 id="server.acme.check_interval"><code>server.acme.check_interval</code></h3>

| | |
|---|---|
| Syntax | `check_interval: <duration> (e.g. 30s)` |
| Default | `43200s` |
| Context | `server.acme` |
| Reload | applies on reload |

How often certificate expiry is checked.


<h3 id="server.acme.contact"><code>server.acme.contact</code></h3>

| | |
|---|---|
| Syntax | `contact: [<string>, ...]` |
| Default | `[]` |
| Context | `server.acme` |
| Reload | applies on reload |

Contact URIs, e.g. `mailto:ops@example.com`.


<h3 id="server.acme.directory"><code>server.acme.directory</code></h3>

| | |
|---|---|
| Syntax | `directory: <string>` |
| Default | `https://acme-v02.api.letsencrypt.org/directory` |
| Context | `server.acme` |
| Reload | applies on reload |

ACME directory URL.


<h3 id="server.acme.enabled"><code>server.acme.enabled</code></h3>

| | |
|---|---|
| Syntax | `enabled: true \| false` |
| Default | `false` |
| Context | `server.acme` |
| Reload | applies on reload |

Obtain and renew certificates for applications with `acme: true`.


<h3 id="server.acme.renew_before"><code>server.acme.renew_before</code></h3>

| | |
|---|---|
| Syntax | `renew_before: <duration> (e.g. 30s)` |
| Default | `2592000s` |
| Context | `server.acme` |
| Reload | applies on reload |

Renew when the certificate expires within this time.


<h3 id="server.acme.state_dir"><code>server.acme.state_dir</code></h3>

| | |
|---|---|
| Syntax | `state_dir: <string>` |
| Default | `/var/lib/scalws/acme` |
| Context | `server.acme` |
| Reload | applies on reload |

Directory for the ACME account, certificates and keys.


<h3 id="server.acme.terms_of_service_agreed"><code>server.acme.terms_of_service_agreed</code></h3>

| | |
|---|---|
| Syntax | `terms_of_service_agreed: true \| false` |
| Default | `false` |
| Context | `server.acme` |
| Reload | applies on reload |

Must be true: the CA's terms of service are accepted on account creation.