# Binhex-herdr-core

Binhex-herdr-core is a Caddy web server container with the DuckDNS DNS challenge plugin that automatically issues Let's Encrypt TLS certificates for DuckDNS hostnames without exposing port 80, making it a useful. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/8919/binhex-herdr-core

## Description

Binhex Herdr Core is a Caddy web server container with the DuckDNS DNS challenge plugin that automatically issues Let's Encrypt TLS certificates for DuckDNS hostnames without exposing port 80, making it a useful home-network reverse proxy.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 3 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/binhex-herdr-core-1n6u55t0u1y55h?q=binhex-herdr-core
- GitHub: https://github.com/binhex/arch-herdr-core

## Common questions

### Where do I put the Caddyfile for this container?

Place it at /config/caddy/Caddyfile. An example with reverse proxy settings is created there on first run.

### Which ports should I map for a basic reverse proxy setup?

Map 8080 for HTTP and 8443 for HTTPS, and set http_port 8080 and https_port 8443 in the Caddyfile global block. The example also maps 2019.

### How do I use DuckDNS for automatic TLS without opening port 80?

Set DUCKDNS_TOKEN and reference it in the Caddyfile as {env.DUCKDNS_TOKEN} inside the duckdns DNS challenge block. The image includes the DuckDNS plugin for Let's Encrypt certificate issuance and renewal.

### Where are Let's Encrypt account data and certificates stored?

Caddy stores them under /config/caddy/data, inside the /config bind mount. If you have an existing deployment, add storage file_system /config/caddy/data to the global options block.

### How can I install extra Arch packages on container startup?

Set ENABLE_STARTUP_SCRIPTS=yes and put scripts in /config/caddy-duckdns/scripts. Use STARTUP_SCRIPTS_MODE wait to run scripts sequentially or parallel to run them at the same time.

---
Source: Our Local Host (https://ourlocalhost.com/app/8919/binhex-herdr-core), the self-hosted and open-source app directory.
