# 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:bookworm-slim | 29.10.2026 00:58 | | aarch64 (arm64) | ✅ Active | debian:bookworm-slim | 29.10.2026 00:58 | --- ## 🐙 Method 1: Docker Compose (Recommended) ### 🚀 1. Create `docker-compose.yml` ```yaml 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 ```bash docker compose pull ``` ### Start container in background ```bash docker compose up -d ``` --- ## 🐳 Method 2: Standalone Container (Docker Run / CLI) ### 🚀 1. Pull the image manually ```bash docker pull git.pi-farm.de/pi-farm/samba-ad-dc:trixie ``` ### 🚀 2. Run the container directly ```bash 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:bookworm-dev ``` *Last updated on: 29.10.2026 00:58* ### 📜 Version History | Version | Date | Status | | :--- | :--- | :--- | | **bookworm-dev** | 29.10.2026 00:58 | ✅ |