Files
samba-ad-dc/README.md
T
2026-10-28 19:22:52 +00:00

98 lines
3.0 KiB
Markdown

# 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.
<a href="https://git.pi-farm.de/pi-farm/samba-ad-dc/actions" target="_blank" rel="noopener noreferrer">
<img src="https://git.pi-farm.de/pi-farm/samba-ad-dc/actions/workflows/build-and-push.yaml/badge.svg?branch=dev" alt="Build Status">
</a>
<a href="https://git.pi-farm.de/pi-farm/samba-ad-dc" target="_blank" rel="noopener noreferrer">
<img src="https://img.shields.io/badge/gitea-pi--farm-609930?logo=gitea&logoColor=white" alt="Gitea Repository">
</a>
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 | ✅ |