Skip to content

Commit 6c9e7ff

Browse files
sl-gnsibianl
andauthored
docs(faq): add two qa (#235)
Co-authored-by: sibianl <sibianl@rings.net.cn>
1 parent 06e2299 commit 6c9e7ff

File tree

2 files changed

+17
-13
lines changed

2 files changed

+17
-13
lines changed

docs/user_guide/install.md

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -38,19 +38,6 @@ pip install -e '.[mac]'
3838

3939
Next time to re-activate this virtual environment, run ```source ./venv/bin/activate```.
4040

41-
<details>
42-
<summary> Note for macOS users regarding network permissions</summary>
43-
44-
On macOS, you need to allow your terminal or IDE (such as Terminal, iTerm2, VS Code, Cursor, etc.) access to the local network in order for Parallax to work correctly. If the application prompts you for network access the first time you run Parallax, click "Allow." If you have already denied access, follow these steps to enable it:
45-
46-
1. Open System Settings from the Apple menu.
47-
2. Click on Privacy & Security in the sidebar.
48-
3. Click on Local Network.
49-
4. For each app listed, turn the ability to access your local network on or off using the toggle switch.
50-
51-
This will ensure Parallax has the proper network permissions for local communication.
52-
</details>
53-
5441
#### Extra step for development:
5542
```sh
5643
pip install -e '.[dev]'

docs/user_guide/quick_start.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,3 +184,20 @@ A: This error typically occurs when the necessary network ports for communicatio
184184
2. Make sure that ports are open to the desired sources (e.g., to all cluster instances, or to your public IPs if required).
185185

186186
After updating the firewall/security group settings to allow these ports, restart your scheduler and nodes.
187+
188+
> Q: When running on macOS, I encounter the error: `error sending packet on iface address No route to host (os error 65) address=192.168.xxx.xxx`. What does this mean and how can I fix it?
189+
190+
A: On macOS, you need to allow your terminal or IDE (such as Terminal, iTerm2, VS Code, Cursor, etc.) access to the local network in order for Parallax to work correctly. If the application prompts you for network access the first time you run Parallax, click "Allow." If you have already denied access, follow these steps to enable it:
191+
192+
1. Open System Settings from the Apple menu.
193+
2. Click on Privacy & Security in the sidebar.
194+
3. Click on Local Network.
195+
4. For each app listed, turn the ability to access your local network on or off using the toggle switch.
196+
197+
This will ensure Parallax has the proper network permissions for local communication.
198+
199+
> Q: When running the scheduler on Windows, nodes on other PCs cannot detect the scheduler ID over the local network. Why can't other machines join the cluster?
200+
201+
A: If you are running Parallax in WSL (Windows Subsystem for Linux), make sure you are using the "Mirrored" networking mode. By default, WSL uses "NAT" (Network Address Translation) mode, which isolates your WSL environment behind a virtual network. As a result, services running inside WSL (such as Parallax scheduler) are not directly accessible from other devices on the LAN.
202+
203+
To ensure that other machines on your network can connect to your WSL instance, change the WSL networking mode to "Mirrored" (supported on Windows 11 version 22H2 or later). In "Mirrored" mode, your WSL environment will share the same network as your host, allowing local network discovery and seamless joining of nodes to your Parallax cluster.

0 commit comments

Comments
 (0)