.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "acme-redirect" "1" "2025-07-17"
.PP
.SH NAME
.PP
acme-redirect - Tiny http daemon that answers acme challenges and redirects
everything else to https
.PP
.SH SYNOPSIS
.PP
\fBacme-redirect\fR 
[-v|--verbose] 
[-c /etc/acme-redirect.\&conf] 
[--config-dir /etc/acme-redirect.\&d] 
[--acme-email <acme-email>] 
[--acme-url https://acme-v02.\&api.\&letsencrypt.\&org/directory] 
[--chall-dir /run/acme-redirect] 
[--data-dir /var/lib/acme-redirect] 
<subcommand>
.PP
.SH DESCRIPTION
.PP
acme-redirect is a tiny http server that implements the ACME (Automated
Certificate Management Environment) protocol and redirects everything else to
https.\& It can run directly on port 80 and supports automatic issuance and renew
of certificates out of the box with minimal configuration.\&
.PP
.SH DAEMON
.PP
Runs the http daemon.\&
.PP
\fB-B <bind-addr>, --bind-addr <bind-addr>\fR
.RS 4
The address to listen on.\& Default is \fB[::]:80\fR.\&
.PP
.RE
\fB--chroot\fR
.RS 4
Chroot into the challenge directory.\&
.PP
.RE
\fB--user <user>\fR
.RS 4
Drop from root to this user.\&
.PP
.RE
\fBacme-redirect daemon\fR
.PP
.SH RENEW
.PP
Renew certificates that are about to expire and run the given commands to
trigger a certificate reload.\&
.PP
\fB-n, --dry-run\fR
.RS 4
Do not actually do anything, just show what would happen.\&
.PP
.RE
\fB--force-renew\fR
.RS 4
Renew certificates even if they are not about to expire.\&
.PP
.RE
\fB--skip-cleanup\fR
.RS 4
Don'\&t clean up old certs that are not live anymore.\&
.PP
.RE
\fB--skip-restarts\fR
.RS 4
Do not execute the configured \fBexec\fR commands.\&
.PP
.RE
\fB<certs .\&.\&.\&>\fR
.RS 4
Only renew specific certs.\& If no certificate is selected explicitly, renew
all certificates.\&
.PP
.RE
\fBacme-redirect renew\fR
.PP
.SH STATUS
.PP
Shows the certificates currently available and their expiry status.\&
.PP
\fBacme-redirect status\fR
.PP
.SH AUTOMATIC RENEW
.PP
You can simply run \fBacme-redirect renew\fR periodically.\& If you'\&re using systemd
you can use the systemd timer with:
.PP
\fBsystemctl enable --now acme-redirect-renew.\&timer\fR
.PP
.SH SEE ALSO
.PP
\fBacme-redirect.\&conf\fR(5), \fBacme-redirect.\&d\fR(5).\&
.PP
.SH AUTHORS
.PP
acme-redirect was originally written by kpcyrd and is hosted at
https://github.\&com/kpcyrd/acme-redirect