.\" This source code is released into the public domain.
.Dd June 3, 2025
.Dt LFACME-RENEW 8
.Os
.Sh NAME
.Nm lfacme renew
.Nd issue or renew ACME certificates
.Sh SYNOPSIS
.Nm lfacme
.Op opts
.Cm renew
.Op Fl f
.Op Ar certificate
.Sh DESCRIPTION
The
.Nm
command examines the ACME certificates configured in
.Xr domains.conf 5 .
If a certificate was previously issued and is still valid for longer than 30
days, it will be ignored.
Otherwise, the certificate will be issued or renewed and any configured hook
scripts will be invoked.
An ACME account must be created using
.Xr lfacme-setup 8
before running
.Nm .
.Pp
If the
.Ar certificate
argument is provided, only the certificate with the given identifier will
be renewed.
Otherwise, all elegible certificates will be renewed.
.Pp
The follow options are accepted:
.Bl -tag -width indent
.It Fl f
Force renewal of certificates, even if the normal renewal date hasn't arrived.
.El
.Sh ENVIRONMENT
Refer to
.Xr lfacme 8
for a list of environment variables which affect the operation of
.Nm .
.Sh SEE ALSO
.Xr domains.conf 5 ,
.Xr lfacme 8 ,
.Xr lfacme-setup 8