Files
samba-ad-dc/README.md
T

2.8 KiB

samba-ad-dc

Samba Active Directory Domain Controller with integrated DNS, Kerberos authentication and Chrony time synchronization. You have to edit the .env file only to your personal needs and start the container.

Build Status Gitea Repository

This repository is built and pushed automatically.

🏗️ Platform Support

Architecture Status Base Image Build Date
x86_64 (amd64) ✅ Active debian:trixie-slim 28.10.2026 21:57
aarch64 (arm64) ✅ Active debian:trixie-slim 28.10.2026 21:57

🚀 1. Create docker-compose.yml

services:
  samba-ad-dc:
    image: git.pi-farm.de/pi-farm/samba-ad-dc:trixie
    container_name: samba-ad-dc
    hostname: ${SAMBA_HOSTNAME}
    domainname: ${SAMBA_DOMAIN}
    restart: unless-stopped
    environment:
      SAMBA_REALM: ${SAMBA_REALM}
      SAMBA_DOMAIN: ${SAMBA_DOMAIN}
      SAMBA_HOSTNAME: ${SAMBA_HOSTNAME}
      SAMBA_FQDN: ${SAMBA_FQDN}
      SAMBA_IP: ${SAMBA_IP}
      SAMBA_NETWORK: ${SAMBA_NETWORK}
      DNS_FORWARDER: ${DNS_FORWARDER}
      SAMBA_ADMIN_PASSWORD: ${SAMBA_ADMIN_PASSWORD}
    volumes:
      - ./config:/etc/samba
      - ./private:/var/lib/samba
      - ./state/log:/var/log/samba
      - ./state/run:/run/samba
    networks:
      samba-ad-lan:
        ipv4_address: ${SAMBA_IP}
    stop_grace_period: 60s

networks:
  samba-ad-lan:
    external: true
    

🚀 2. Pull & start the container

Pull or update the image

docker compose pull

Start container in background

docker compose up -d

🐳 Method 2: Standalone Container (Docker Run / CLI)

🚀 1. Pull the image manually

docker pull git.pi-farm.de/pi-farm/samba-ad-dc:trixie

🚀 2. Run the container directly

docker run -d \
  --name samba-ad-dc \
  --restart unless-stopped \
  -e SAMBA_REALM=YOUR-DOMAIN.LOC \
  -e SAMBA_DOMAIN=YOURDOMAIN \
  -e SAMBA_HOSTNAME=DC01 \
  -e SAMBA_FQDN=dc01.your-domain.loc \
  -e SAMBA_IP=192.168.178.10 \
  -e SAMBA_NETWORK=192.168.178.0/24 \
  -e DNS_FORWARDER=192.168.178.1 \
  -e SAMBA_ADMIN_PASSWORD=CHANGE-THIS-TO-A-STRONG-SECRET \
  git.pi-farm.de/pi-farm/samba-ad-dc:trixie

Last updated on: 28.10.2026 21:57

📜 Version History

Version Date Status
trixie 28.10.2026 21:57 prepare for main ✅