HOWTO: Local v8 Web Control

[calxalot]

HOWTO: Local v8 Web Control v8.5

What?

Use a local Web Control served by the client.

Why?

• Want partial control of local client when internet is down
• Want to use Safari to direct connect to local client
• Have problems accessing https://v8-5.foldingathome.org

Why not?

• Must be manually updated
• 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://master.foldingathome.org/builds ... se/latest/

Note that this is from bleeding edge builds.
These builds may occasionally be broken and can have an incorrect version number in file name.

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/

On Linux it is

Code: Select all

/var/lib/fah-client/

Note: fah-web-control.zip is being built on only one worker, but the files are identical for all platforms.


Restart client

macOS

Code: Select all

sudo /bin/launchctl stop org.foldingathome.fahclient
sudo /bin/launchctl start org.foldingathome.fahclient

Linux

Code: Select all

sudo /usr/bin/systemctl restart fah-client

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/

Use http://localhost:7396/machines if you get redirected to the public web site.


Edited for v8.5 on 2024-01-15

[daiko]

Thanks, calxalot. I appreciate the option to run local on MacOS (Ventura 13.2.1). I’m back to using Safari for folding control.
I downloaded and installed the latest beta from the given link, and it picked up where the previous version left off, no problems.

[calxalot]

I have recently been asked for terminal commands to install the local web control.
You are encouraged to use your desktop GUI instead.

But if you must, this works on ubuntu 22.04 for the release version:
Edit 2025-01-15: this has been updated for 8.5.7 and is untested.

Code: Select all

cd /tmp
wget -O latest.zip \
  https://master.foldingathome.org/builds/fah-web-control/debian-13-64bit/release/latest/fah-web-control_8.5.7.zip
unzip latest.zip
rm latest.zip
mv fah-web-control_* fah-web-control
sudo /usr/bin/rm -r /var/lib/fah-client/fah-web-control/
sudo /usr/bin/mv fah-web-control /var/lib/fah-client/.

Untested gets latest:

Code: Select all

cd /tmp
base="https://master.foldingathome.org/builds/fah-web-control/debian-13-64bit/release/latest/"
# Download last zip file on page; extract, rename fah-web-control dir
zipfile=$(wget -q -O - "$base" | awk -F'"' '/href=.*\.zip/{print $2}' | tail -1)
wget -q "${base}${zipfile}" && unzip -q "$zipfile" && rm "$zipfile"
mv -v fah-web-control_8*/ fah-web-control
sudo /usr/bin/mv -f fah-web-control /var/lib/fah-client/.

Open http://localhost:7396/machines

If it won't load, restart the client and reload the web page.

Code: Select all

sudo /usr/bin/systemctl restart fah-client

[JoeDaCabbie]

Hola! I just tried re-installing 8.3.18 again because v7 was causing my machine to restart too frequently and am getting the 'DNS lookup failed for cores2.foldingathome.org' message again. On a whim, I ran cores2 through the RDAP.ORG Validator tool and got an Error 404 message. Are you all sure you've got that domain set up correctly?

Results
Version is 0.0.1.
Punycode.js version is 2.3.1.
Testing URL is 'cores2.foldingathome.org.
Response type is 'domain'.
Server type is 'vanilla'.
Sending request...
Received a response from the server.
HTTP status 404 MUST be less than 400.

[toTOW]

cores2.foldingathome.org won't let you access anything unless you know the full link to the file.