main
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.
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 |
🐙 Method 1: Docker Compose (Recommended)
🚀 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 | ✅ |
Languages
Shell
84.2%
Dockerfile
15.8%