acme-redirect(1)

📦
version 0.8.1 · 3 versions
, in alpine 3.24

💖 NAME 💖

okay bestie, welcome to acme-redirect(1) from the General Commands Manual — this is the page for acme-redirect, a tiny http daemon that answers acme challenges and redirects everything else to https. ✨

🌸 SYNOPSIS 🌸

here's the whole shape of it, no cap:

acme-redirect [-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>

🦋 DESCRIPTION 🦋

so 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. periodt. 💅

👑 DAEMON 👑

this subcommand runs the http daemon. main character energy fr.

  • -B <bind-addr>, --bind-addr <bind-addr> — the address to listen on. default is [::]:80.
  • --chroot — chroot into the challenge directory.
  • --user <user> — drop from root to this user.
acme-redirect daemon

🔁 RENEW 🔁

renews certificates that are about to expire and runs the given commands to trigger a certificate reload. very “keep the vibes fresh” of it. ✨

  • -n, --dry-run — do not actually do anything, just show what would happen.
  • --force-renew — renew certificates even if they are not about to expire.
  • --skip-cleanup — don't clean up old certs that are not live anymore.
  • --skip-restarts — do not execute the configured exec commands.
  • <certs ...> — only renew specific certs. if no certificate is selected explicitly, renew all certificates.
acme-redirect renew

⭐ STATUS ⭐

shows the certificates currently available and their expiry status. literally a vibe check for your certs. 💅

acme-redirect status

🔄 AUTOMATIC RENEW 🔄

you can simply run acme-redirect renew periodically. if you're using systemd you can use the systemd timer with:

systemctl enable --now acme-redirect-renew.timer

🎀 SEE ALSO 🎀

💜 AUTHORS 💜

acme-redirect was originally written by kpcyrd and is hosted at https://github.com/kpcyrd/acme-redirect 🫶

that's the whole page, bestie — acme-redirect(1) from the General Commands Manual, dated 2026-10-22. stay slay, and may all your redirects be https. 💖✨

📦 where this page comes from