dockname

A simple label-based reverse proxy that makes container routing effortless in development environments.

Docker Hub License Go Report Card Image Size

🎯 Simple Configuration

Label-based configuration makes setup a breeze

🔄 Auto Discovery

Automatic container discovery and configuration

🚀 Easy Setup

Works with .localhost domains - no /etc/hosts editing required

🛡️ Lightweight

Tiny footprint optimized for development environments

Size Comparison

Solution Image Size Relative Size
dockname 10.9MB 1x (Base)
Traefik 185MB 17x larger
Nginx Proxy Manager 1.09GB 100x larger

Quick Start

services:
  proxy:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    user: root
    restart: always

  web:
    image: nginx:latest
    labels:
      - "dockname.domain=web.localhost"
      - "dockname.port=80"

Launch with:

docker compose up -d

Visit http://web.localhost in your browser!

Label Configuration

Label Description Example
dockname.domain Access domain web.localhost
dockname.port Container port (default: 80) 80