You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: content/docs/installation/docker.md
+3-33Lines changed: 3 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,8 +17,7 @@ services:
17
17
dragonfly:
18
18
image: ghcr.io/riffcc/dragonfly:latest
19
19
restart: unless-stopped
20
-
ports:
21
-
- "3000:3000"
20
+
network_mode: host
22
21
volumes:
23
22
- dragonfly-data:/var/lib/dragonfly
24
23
environment:
@@ -34,38 +33,9 @@ Then run:
34
33
docker compose up -d
35
34
```
36
35
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`.
43
37
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.
0 commit comments