96 lines
2.8 KiB
Markdown
96 lines
2.8 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=main" 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 21:57 |
|
|
| aarch64 (arm64) | ✅ Active | debian:trixie-slim | 28.10.2026 21:57 |
|
|
|
|
---
|
|
|
|
## 🐙 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
|
|
|
|
```
|
|
|
|
*Last updated on: 28.10.2026 21:57*
|
|
|
|
### 📜 Version History
|
|
| Version | Date | Status |
|
|
| :--- | :--- | :--- |
|
|
| **trixie** | 28.10.2026 21:57 | prepare for main ✅ | |