whatisgithub

What is acme-companion?

umireon/acme-companion — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2021-05-06

Audience · ops devopsComplexity · 3/5DormantSetup · hard

In one sentence

An automation tool that gets and renews free HTTPS certificates for your Dockerized web apps, working alongside nginx-proxy so you never manage SSL by hand.

Mindmap

mindmap
  root((acme-companion))
    What it does
      Watches Docker containers
      Requests SSL certificates
      Auto-renews before expiry
      Configures nginx-proxy
    Tech stack
      Docker
      nginx-proxy
      acme.sh
      Let's Encrypt
    Use cases
      HTTPS for microservices
      Secure internal dashboards
      Multi-container hosting
    Audience
      Docker hosters
      Startups
      Ops teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically get and renew HTTPS certificates for multiple Dockerized apps on one server

USE CASE 2

Run Grafana, a wiki, and an API on the same host with valid HTTPS for each

USE CASE 3

Avoid manual SSL certificate management for a microservices setup

USE CASE 4

Secure internal tools and dashboards with proper certificates without extra work

What is it built with?

Dockernginx-proxyacme.sh

How does it compare?

umireon/acme-companion0verflowme/alarm-clock0verflowme/seclists
Language—CSS—
Last pushed2021-05-062022-10-032020-05-03
MaintenanceDormantDormantDormant
Setup difficultyhardeasyeasy
Complexity3/52/51/5
Audienceops devopsvibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires three linked Docker containers with shared volumes and a publicly reachable host on ports 80/443.

Copy-paste prompts

Prompt 1
Walk me through setting up nginx-proxy and acme-companion together with shared Docker volumes.
Prompt 2
Show me the environment variables I need to set on a container so acme-companion requests a certificate for its domain.
Prompt 3
Explain what happens when a certificate is about to expire and how renewal is triggered.
Prompt 4
Help me troubleshoot why acme-companion can't verify domain ownership for my container.

Frequently asked questions

What is acme-companion?

An automation tool that gets and renews free HTTPS certificates for your Dockerized web apps, working alongside nginx-proxy so you never manage SSL by hand.

Is acme-companion actively maintained?

Dormant — no commits in 2+ years (last push 2021-05-06).

How hard is acme-companion to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is acme-companion for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?