Files
samba-ad-dc/README.md
T

3.3 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 29.10.2026 10:25
aarch64 (arm64) ✅ Active debian:trixie-slim 29.10.2026 10:25

🚀 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
    privileged: true
    network_mode: host
    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
stop_grace_period: 60s

and .env

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=SuperSecretPassword!1234!

🚀 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: 29.10.2026 10:25

📜 Version History

Version Date Status
trixie 29.10.2026 10:25 add .env description in README.md ✅
trixie 29.10.2026 10:23 add .env ✅
trixie 29.10.2026 10:01 chmod 750 for ntp ✅
trixie 29.10.2026 09:54 ✅
trixie 29.10.2026 09:52 add networkmode host ✅
trixie 29.10.2026 00:37 ✅
trixie 29.10.2026 00:26 ✅