Files
samba-ad-dc/README.md
T
2026-10-28 15:24:29 +00:00

104 lines
3.1 KiB
Markdown

# samba-ad-dc
Samba Active Directory Domain Controller with integrated DNS, Kerberos authentication and Chrony time synchronization.
<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" 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 16:24 |
| aarch64 (arm64) | ✅ Active | debian:trixie-slim | 28.10.2026 16:24 |
---
## 🐙 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-dev
container_name: samba-ad-dc
hostname: ${SAMBA_HOSTNAME}
domainname: ${SAMBA_DOMAIN}
restart: unless-stopped
privileged: true
environment:
- 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=CHANGE-THIS-TO-A-STRONG-SECRET
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-dev
```
### 🚀 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 16:24*
### 📜 Version History
| Version | Date | Status |
| :--- | :--- | :--- |
| **trixie-dev** | 28.10.2026 16:24 | ✅ |
| **trixie-dev** | 28.10.2026 16:14 | ✅ |
| **trixie-dev** | 28.10.2026 16:09 | rename to rm.template ✅ |
| **trixie-dev** | 28.10.2026 15:48 | rm environment ✅ |
| **trixie-dev** | 28.10.2026 15:38 | ✅ |
| **trixie-dev** | 28.10.2026 15:34 | add README.template ✅ |
| **trixie-dev** | 28.10.2026 15:30 | add docker-compose.template ✅ |
| **trixie-samba-ad-dc-de-dev** | 28.10.2026 14:14 | ✅ |