Files
samba-ad-dc/README.md
T
2026-10-28 14:48:37 +00:00

3.0 KiB

samba-ad-dc

Samba Active Directory Domain Controller with integrated DNS, Kerberos authentication and Chrony time synchronization.

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 15:48
aarch64 (arm64) ❌ Not supported debian:trixie-slim 28.10.2026 15:48

🚀 1. Create docker-compose.yml

services:
  samba-ad-dc:
    image: git.pi-farm.de/pi-farm/samba-ad-dc:trixie-dev
    container_name: samba-ad-dc
    hostname: ${SAMBA_HOSTNAME}
    domainname: ${SAMBA_DOMAIN}
    restart: unless-stopped
    privileged: true
    environment:
      - SAMBA_REALM=YOUR-DOMAIN.LOC
      - SAMBA_DOMAIN=YOURDOMAIN
      - SAMBA_HOSTNAME=DC01
      - SAMBA_FQDN=dc01.your-domain.loc
      - SAMBA_IP=192.168.178.10
      - SAMBA_NETWORK=192.168.178.0/24
      - DNS_FORWARDER=192.168.178.1
      - SAMBA_ADMIN_PASSWORD=CHANGE-THIS-TO-A-STRONG-SECRET

    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-dev

🚀 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-dev

Last updated on: 28.10.2026 15:48

📜 Version History

Version Date Status
trixie-dev 28.10.2026 15:48 rm environment ✅
trixie-dev 28.10.2026 15:38 ✅
trixie-dev 28.10.2026 15:34 add README.template ✅
trixie-dev 28.10.2026 15:30 add docker-compose.template ✅
trixie-samba-ad-dc-de-dev 28.10.2026 14:14 ✅