diff --git a/README.md b/README.md
index b7ac7c1..494b1db 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,83 @@
# samba-ad-dc
+Samba Active Directory Domain Controller with integrated DNS, Kerberos authentication and Chrony time synchronization.
+
+
+
+
+
+
+
+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 14:14 |
+| aarch64 (arm64) | ❌ Not supported | debian:trixie-slim | 28.10.2026 14:14 |
+
+---
+
+## 🐙 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-samba-ad-dc-de-dev
+ container_name: samba-ad-dc
+ restart: unless-stopped
+
+ 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
+
+
+```
+### 🚀 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-samba-ad-dc-de-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-samba-ad-dc-de-dev
+
+```
+
+*Last updated on: 28.10.2026 14:14*
+
+### 📜 Version History
+| Version | Date | Status |
+| :--- | :--- | :--- |
+| **trixie-samba-ad-dc-de-dev** | 28.10.2026 14:14 | ✅ |
\ No newline at end of file
diff --git a/VERSION.history b/VERSION.history
new file mode 100644
index 0000000..33bf3b6
--- /dev/null
+++ b/VERSION.history
@@ -0,0 +1 @@
+| **trixie-samba-ad-dc-de-dev** | 28.10.2026 14:14 | ✅ |
diff --git a/docker-compose.yml b/docker-compose.yml
index 98b77d3..1babec7 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,33 +1,16 @@
services:
samba-ad-dc:
- build:
- context: .
- dockerfile: Dockerfile
- image: pi-farm-samba-ad:latest
+ image: git.pi-farm.de/pi-farm/samba-ad-dc:trixie-samba-ad-dc-de-dev
container_name: samba-ad-dc
- hostname: ${SAMBA_HOSTNAME}
- domainname: ${SAMBA_DOMAIN}
restart: unless-stopped
- privileged: true
- 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
+ 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
+