OSX Install Guide

Software Version 7.3.x+ (V7)


Introduction to V7

The new Folding@home (FAH) software is configured, controlled, and monitored through a new simpler graphical interface named Web Control. This new web browser based application has incorporated many new features, including client monitoring and configuration of all FAH clients. Web Control is now the recommended interface for all FAH types (Single core CPU, Multi-core CPU, GPU), replacing the v6 System Preferences versions of FAH.  The more advanced FAHControl application is also available.

What is new in V7?

We are pleased to say that everything is new in this version, using completely new software coding from the ground up. Our goal is to include the best features from the previous clients, make improvements where possible, discard what was no longer needed, then add new features like the quick start Express mode installer, the new FAHViewer, and the new unified interface. V7 has all of these and more, making installation and configuration much simpler and faster for new users, while continuing to support advanced options.

Note: There are too many updated and new features to list in an Installation Guide, so this section only covers What’s New when installing V7 software. Please read the V7 Introduction page for basic information and explanations of the new client features.

New Terminology

The V7 software really changes the concept of how people interact with FAH. And with new concepts come new or updated terms to describe those concepts. Learning new references is part of the process for change and improvement.

    • Web Control – This is the new simpler graphical interface (front-end). Web Control will configure and monitor one or more FAHClient slots through an easy to use web page.  This is the default control program.
    • FAHControl – This is an alternate new graphical interface (advanced front-end). FAHControl will configure and monitor one or more FAHClient (slots), on one or more computers. This more advanced interface is optional.
    • FAHClient – This is the (back-end) client software managed by FAHControl and typically runs behind the scene. This is a truly unified client (slot) manager. FAHClient starts one or multiple instances of a Fahcore and manages the work assignments for each of these client “slots.”
    • FAHSlot – aka “slot” – Each Fahcore and the data associated with it is called a slot. For example, one FAHSlot can be associated with a GPU and another slot associated with the CPU. Each folding slot can download, process, and upload results independently. The FAHClient manages each slot, and FAHControl monitors and displays their progress independently.
    • FAHViewer – This is the new and fully functional work unit viewer. FAHViewer is modeled after the very popular PS3 viewer, and continues to offer the many rendering options, ball and stick, space fill, zoom, rotation, etc., and adds snapshot capture and cycling to show folding in action.
See also the FAHControlFAHClient, and FAHViewer documents for more information about setup and customization options.


The new V7 software has the same basic hardware and operating system requirements as the previous clients. However, a few software specific requirements have changed to support newer features. Listed by slot type:

  • CPU Slot Requirements
    • OSX 10.6 or later
    • 64 bit CPU (core 2 duo or better)
    • Broadband internet connection or faster
  • GPU Slot Requirements
    • GPU folding is not currently supported in OSX

Note: Under OSX, antivirus software can interfere with the Folding@home client files and cause errors. We suggest configuring antivirus software to exclude the FAH client directory and especially the Work directory from the antivirus scanning list. This can be done by going into the exclusion list panel that every antivirus program has. The work subdirectory contains semi-random binary data and can confuse overly aggressive heuristic virus scanning.

Quick Start

This section describes how to get started folding quickly with the new V7 software and the default FAHClient slot(s).

  • Download and run the installer.
    • Click Continue, Continue, Agree, Install.
    • Enter admin user name and password.
    • Click OK, Close.
  • Web Control page opens
    • Enter a name and/or team #, and Passkey.  Always use a Passkey.
    • Click Save.
  • Done.

After the download, the new V7 software is installed and folding in under 1 minute. Very quick and easy. For a more guided installation, please see the Standard Install section.

Standard Installation – Recommended! (All Users)

This section describes the recommended method for installing the V7 FAH software for individual FAHClient slot(s) on Mac OSX 10.6.x and later. A first time installation is assumed. And unless otherwise noted, the default setting for each option is the recommended setting.

Download the V7 Installer package from here (see figure 1). The installer includes the new Web Control (client manager) interface software, the new FAHClient (slot manager) software, and the new FAHViewer (viewer) software.  The optional FAHControl (advanced client manager) is also included.

Installer PackageFigure 1

If you have “Open ‘safe’ files after downloading” selected in Safari, the zip file will be automatically expanded for you (see figure 2).  Otherwise, double-click the zip file in figure 1 to expand it.

Expanded PackageFigure 2

Double-click the package to install.

The informational welcome panel is displayed (see figure 3).

Welcome to FAHFigure 3

 Click Continue.

The license agreement is displayed (see figure 4).

LicenseFigure 4

Please read the agreement, then click Continue.

The option to agree to the license is shown (see figure 5).

License AgreementFigure 5

If agreeable, click Agree to continue.

Select a Destination panel may be displayed.  Note that installation is only allowed on the boot disk (see figure 6).

LocationFigure 6

Select the boot disk, then click Continue.

The standard install panel is displayed (see figure 7).

Standard InstallFigure 7

The option to customize is presented.  The default settings are recommend for the standard install.

 Click Install to proceed.

The installer prompts for an administrator name and password (see figure 8).

AuthenticationFigure 8

Enter an administrative Name and Password.  Click OK to continue.

After a successful installation, this panel is displayed (see figure 9).

SuccessFigure 9

Click Close.

The installer will quit and the web browser will open to configure the running client.

The Web Control (client manager) interface will start automatically after a few seconds. The Web Control page will prompt to configure a FAH user identity (see figure 10).

Configure IDFigure 10

Click the Configure an Identity button unless choosing to fold Anonymously.

The Web Control Identity tab is displayed (see figure 11).

Web Control, Enter IDFigure 11

Enter a FAH user Name, Team #, and Passkey as needed.  Always use a Passkey.

Note: Using a Passkey adds an extra level of security, and is also a requirement to receive Quick Return Bonus points.

Click Save to continue.

The Web Control Home tab is displayed (see figure 12).

Web ControlFigure 12

V7 software is now installed and folding.

Please read the V7 Introduction page for basic information and further explanations of the new client features.

See also the FAHControl, FAHClient, and FAHViewer documents for more information about setup and customization options.

While the default options are typically the recommended options, see the Configuration FAQ for additional setup options.


Command Line Only Option

The command line only stand alone FAHClient tarball is available for download from here.

Note: There is no install guide or support in the forum for this type of expert only installation. The only support for command-line only installs is this:


 FAHClient --help

Configuration using config.xml:

 FAHClient --configure

Configuration with no config file (minimum flags):

 FAHClient --user=Anonymous --team=0 --passkey=1385yourpasskeyhere5924 --gpu=true --smp=true

Table of Options

This Client Differences v6 to V7 table lists some of the more common V7 options.


How to Uninstall V7

This section describes how to uninstall V7 FAH application.

Please exit the application, then begin.

For Mac OSX, there is a third-party removal tool, located at the bottom of the this page. Stanford University does not provide any warranty for this tool. If you need further information, please visit the Folding Forum.

What if the suggestions above do not work?

If you are having difficulties with the uninstallations, please visit the Folding Forum for further help.

Install Guide Updates

I found a better way to install the V7 client, where can I make a suggestion?

The install guides are written and updated by the folding community, and managed by the Pande Group. Please post any suggestions, corrections, or update recommendations to the corresponding Guides topic in the Folding Forum. And thank you for helping to improve the install guides.


For More Information, Please See:

Last Updated on July 12, 2013, at 05:01 PM

Add your computer's power to over 327,000 others that are helping us find cures to Alzheimer's, Huntington's, Parkinson's and many cancers ...

... in just 5 minutes.

Step 1.

Download protein folding simulation software called



Step 2.

Run the installation. The software will automatically start up and open a web browser with your control panel.

Step 3.

Follow the instructions to Start Folding.

Stanford University

will send your computer a folding problem to solve. When your first job is completed, your computer will swap the results for a new job.

Download the protein folding simulation software that fits your machine.


Installation guide
Or download Folding@home for your Android (4.4+) phone.