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
Add Docker install instructions and WSL2 troubleshooting
- Add Docker section to quickstart with basic run command
- Document Windows WSL2 networking configuration needed for UDP
- Include Hyper-V firewall fix for peer-to-peer connections
Thanks to fluffomat for diagnosing and documenting the WSL2 fix.
Co-Authored-By: Claude <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: hugo-site/content/quickstart/_index.md
+43Lines changed: 43 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,6 +36,16 @@ cargo install freenet
36
36
37
37
Then start Freenet with `freenet network`.
38
38
39
+
### Docker
40
+
41
+
Freenet provides official Docker images. Pull and run with:
42
+
43
+
```bash
44
+
docker run -p 50509:50509 -p 56208:56208/udp freenetorg/freenet:latest
45
+
```
46
+
47
+
**Windows (WSL2) users:** Docker Desktop on Windows requires additional configuration for UDP networking. See the [Windows WSL2 Setup](#windows-wsl2-docker-setup) section in Troubleshooting below.
48
+
39
49
## Step 2: Join Freenet Official
40
50
41
51
Get an invite to our community chat. You can request up to 5 invites per day.
@@ -50,6 +60,39 @@ If you run into problems, join our [Matrix chat](https://matrix.to/#/#freenet-lo
50
60
51
61
**Network requirements:** Freenet uses UDP hole punching for peer-to-peer connections. Most home routers support this without configuration. Strict corporate firewalls may block connections.
52
62
63
+
### Windows WSL2 Docker Setup
64
+
65
+
Docker Desktop on Windows uses WSL2, which has networking layers that can block Freenet's UDP peer-to-peer connections. If River won't load or gets stuck at "Subscribing to room", follow these steps:
0 commit comments