Skip to content

Commit eb3e140

Browse files
Zorlinclaude
andcommitted
docs: Use host networking as default for Docker
DHCP/TFTP need direct network access for PXE boot — port forwarding doesn't work for broadcast protocols. Host networking is the only correct configuration. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 279ca72 commit eb3e140

2 files changed

Lines changed: 4 additions & 35 deletions

File tree

content/docs/installation/docker.md

Lines changed: 3 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,7 @@ services:
1717
dragonfly:
1818
image: ghcr.io/riffcc/dragonfly:latest
1919
restart: unless-stopped
20-
ports:
21-
- "3000:3000"
20+
network_mode: host
2221
volumes:
2322
- dragonfly-data:/var/lib/dragonfly
2423
environment:
@@ -34,38 +33,9 @@ Then run:
3433
docker compose up -d
3534
```
3635

37-
Visit the web interface at `http://localhost:3000`
38-
(or `http://your-hostname:3000` if you're not running it locally).
39-
40-
### Networking for PXE boot
41-
42-
The default port-forwarded configuration works for the web UI and basic management. If you need PXE boot functionality (DHCP and TFTP), you'll need host networking:
36+
Visit the web interface at `http://your-hostname:3000`.
4337

44-
```yaml
45-
services:
46-
dragonfly:
47-
image: ghcr.io/riffcc/dragonfly:latest
48-
restart: unless-stopped
49-
network_mode: host
50-
volumes:
51-
- dragonfly-data:/var/lib/dragonfly
52-
environment:
53-
- RUST_LOG=info
54-
55-
volumes:
56-
dragonfly-data:
57-
```
58-
59-
Host networking is required because DHCP uses broadcast packets and TFTP requires direct socket access, which don't work through Docker's port forwarding.
60-
61-
### Customising the port
62-
63-
To run on a different port, change the port mapping:
64-
65-
```yaml
66-
ports:
67-
- "8080:3000" # Access on port 8080 instead
68-
```
38+
Host networking is required because Dragonfly's DHCP and TFTP services need direct access to the network for PXE boot functionality.
6939

7040
### Data persistence
7141

content/docs/installation/quick-start.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,7 @@ services:
1919
dragonfly:
2020
image: ghcr.io/riffcc/dragonfly:latest
2121
restart: unless-stopped
22-
ports:
23-
- "3000:3000"
22+
network_mode: host
2423
volumes:
2524
- dragonfly-data:/var/lib/dragonfly
2625
environment:

0 commit comments

Comments
 (0)