# 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 | 28.10.2026 20:22 |
| aarch64 (arm64) | ✅ Active | debian:trixie-slim | 28.10.2026 20:22 |
---
## 🐙 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:trixie-dev
```
*Last updated on: 28.10.2026 20:22*
### 📜 Version History
| Version | Date | Status |
| :--- | :--- | :--- |
| **trixie-dev** | 28.10.2026 20:22 | ✅ |
| **trixie-dev** | 28.10.2026 20:16 | fix missing environment ✅ |
| **trixie-dev** | 28.10.2026 20:15 | fix build-and-push status ✅ |
| **trixie-dev** | 28.10.2026 20:07 | ✅ |