DockName

A zero-config reverse proxy that makes container routing effortless in development environments. Automatically detects your containers and makes them accessible via .localhost domains.

🎯 Zero Config

No configuration needed - just add the proxy service

🔄 Auto Discovery

Automatic container detection and domain generation

🚀 Smart Routing

Intelligent port detection and service mapping

🛡️ 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

How It Works

1. Service Discovery

DockName automatically detects your running containers and their configurations.

2. Domain Generation

Creates .localhost domains based on your service names (e.g., web → web.localhost).

3. Port Detection

Intelligently detects and maps container ports for seamless routing.

Quick Start

services:
  proxy:
    image: kiwamizamurai/dockname
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    user: root
    restart: always

  # Example web service
  web:
    image: nginx:latest
    ports:
      - "4000:80"
    labels:
      - "dockname.port=80"
    # -> http://web.localhost

  # Example database service
  db:
    image: postgres:latest
    ports:
      - "5432:5432"
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    # -> http://db.localhost

  # Example database management UI
  dbadmin:
    image: dpage/pgadmin4:latest
    ports:
      - "8080:80"
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@example.com
      PGADMIN_DEFAULT_PASSWORD: admin
    # -> http://dbadmin.localhost

Launch with:

docker compose up -d

Your services are instantly accessible via their .localhost domains:

http://web.localhost - Nginx web server
http://db.localhost - PostgreSQL database
http://dbadmin.localhost - pgAdmin database management