HOWTO: Local v8 Web Control
Posted: Mon Feb 13, 2023 11:57 am
HOWTO: Local v8 Web Control v8.3
What?
Use a local Web Control served by the client.
Why?
Prerequisites
Download and install pre-built Web Control
https://download.foldingathome.org/rele ... l/release/
Unarchive and rename extracted directory to just "fah-web-control".
Move it into the fah data directory.
On macOS, the data directory is
On Linux it is
The latest alpha may only be in bleeding edge builds.
Note that these builds might be broken and have a wrong version number.
https://master.foldingathome.org/builds/fah-client/
Note: fah-web-control.zip is being built on macOS, but the files are identical for all platforms.
Optional: Allow direct remote control of local client
WARNING: This is a security risk.
See HOWTO: Allow v8 Client Remote Control
Optional: Add hostname as an allowed origin to config.xml (versions 8.3 only)
Replace my-computer wherever it appears in this document with output of command hostname. Use lowercase.
The hostname must end with ".local".
Restart client
macOS
Linux
Windows
Use sys tray fah client icon menu to quit. Then relaunch via Start menu > Folding@home.
Enjoy
To access local Web Control, open
http://localhost:7396/machines
If you use http://localhost:7396 you may get redirected to the online site.
For remote browser connection to a local Web Control (requires optional steps above), open
http://my-computer.local:7396/machines
Edited for v8.3.17 on 2024-06-28
v8.4 Web Control does not support remote browser connection to a local Web Control.
What?
Use a local Web Control served by the client.
Why?
- Want to use Safari to direct connect to local client
- Have problems accessing https://v8-3.foldingathome.org
- Want to use remote or mobile (phone/tablet) browser to direct connect to a client on LAN
- Must be manually updated
- Insecure if allowing remote direct connection
- May still access servers at foldingathome.org. This is not an offline solution.
Prerequisites
- Administrator account so you can use sudo
- Comfortable using the command line in Terminal
Download and install pre-built Web Control
https://download.foldingathome.org/rele ... l/release/
Unarchive and rename extracted directory to just "fah-web-control".
Move it into the fah data directory.
On macOS, the data directory is
Code: Select all
/Library/Application Support/FAHClient/
Code: Select all
/var/lib/fah-client/
Note that these builds might be broken and have a wrong version number.
https://master.foldingathome.org/builds/fah-client/
Note: fah-web-control.zip is being built on macOS, but the files are identical for all platforms.
Optional: Allow direct remote control of local client
WARNING: This is a security risk.
See HOWTO: Allow v8 Client Remote Control
Optional: Add hostname as an allowed origin to config.xml (versions 8.3 only)
Replace my-computer wherever it appears in this document with output of command hostname. Use lowercase.
The hostname must end with ".local".
Code: Select all
<allowed-origins v='https://app.foldingathome.org http://localhost:7396 http://my-computer.local:7396'/>
Restart client
macOS
Code: Select all
sudo /bin/launchctl stop org.foldingathome.fahclient
sudo /bin/launchctl start org.foldingathome.fahclient
Code: Select all
sudo /usr/bin/systemctl restart fah-client
Use sys tray fah client icon menu to quit. Then relaunch via Start menu > Folding@home.
Enjoy
To access local Web Control, open
http://localhost:7396/machines
If you use http://localhost:7396 you may get redirected to the online site.
For remote browser connection to a local Web Control (requires optional steps above), open
http://my-computer.local:7396/machines
Edited for v8.3.17 on 2024-06-28
v8.4 Web Control does not support remote browser connection to a local Web Control.