# 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 | |
| aarch64 (arm64) | ✅ Active | debian:trixie-slim | |
---
## 🐙 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
privileged: true
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: *
### 📜 Version History
| Version | Date | Status |
| :--- | :--- | :--- |