Installing BOINC

From BOINC
Jump to: navigation, search

Microsoft Windows

Download the installer, then double-click the installer icon.

Install options

You can set install options by clicking the "Advanced" button on the configuration screen. The options are:

  • Program directory - where BOINC's program files will be stored.
  • Data directory - where BOINC's data files will be stored. This will be a hidden directory. Where it is is shown in the BOINC start up messages.
  • Use BOINC screensaver - Use the BOINC screensaver for the current user.
  • Service install - (FKA Protected application execution) Run project applications under an unprivileged account. This provides increased protection against faulty applications, but it prevents BOINC from using your GPU, and it may cause graphics to not work with older applications.
  • Allow all users on this computer to control BOINC - If selected (public mode), all users can control BOINC (attach/detach projects, etc.). If not selected (private mode), the only users who can control BOINC are: the installing user, members of the Administrator group, and members of the 'boinc_users' group. When other users run the BOINC Manager, they'll be shown a dialog saying to contact the administrator to add them to the 'boinc_users' group.

Running BOINC invisibly

To run BOINC invisibly, choose the "Service install" option (FKA Protected application execution), then delete the BOINC shortcut from the Start/Programs/BOINC and Start/Programs/Startup menus (locate BOINC in each menu, right-click, select Delete). You can still run the BOINC Manager by going to C:\Program Files\BOINC and double-clicking on boincmgr.exe

Error recovery

If you get an error error 1714 - the old installation can't be removed when installing a new version of BOINC:

  • Reinstall the previous version.
  • Uninstall the previous version.
  • Install the new version again.

Mac OS X

  • Download the installer.
  • If your browser has not already done so, expand the zip archive by double-clicking on it in the Finder.
  • Double-click on the BOINC Installer application to run the installer, then follow the prompts.
  • Close the installer when it is finished. This will automatically launch the BOINC Manager.
  • If you want BOINC to be your screen saver, open System Preferences from the Apple menu. Select Desktop & Screen Saver and select BOINCSaver.
  • The default location for data directory of BOINC is /Library/Application Support/BOINC Data. You may want to exclude this folder from Time Machine backup system to prevent increase of backup data size.

Several tools for Mac OS X are available to:

  • Automatically run BOINC as a daemon or system service at boot time.
  • Improve security for stand-alone clients.
  • Prevent BOINC Manager from launching automatically when selected users log in.

Linux

The recommended way to install the BOINC client on Linux is to use the package management system of your Linux distribution. If the BOINC client does not exist for your distribution, please open an issue in github. Note that there are two packages, one for the BOINC Client and another for the BOINC Manager, which can be installed separately. Only the client is required but it is likely that the manager is wanted as well unless the client is to be managed from a remote host.

Debian

Open a terminal and enter the following command:

sudo apt-get install boinc-client boinc-manager

Ubuntu

Use the software centre to install the BOINC manager or following instructions for Debian.

Fedora

Open a terminal and enter the following command:

sudo dnf install boinc-manager

Redhat/CentOS

To Ensure that the EPEL repository is enabled, open a terminal and enter the following command:

wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum localinstall http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Open a terminal and enter the following command:

sudo yum install boinc-client boinc-manager

Building from Source

The source code for BOINC can be obtained from the github repository. This can be done with the following command:

wget https://github.com/BOINC/boinc/archive/master.zip

It can the be built with the following commands

unzip master.zip
cd boinc-master
./_autosetup
./configure \
  --disable-silent-rules \
  --enable-dynamic-client-linkage \
  --disable-server \
  --disable-fcgi \
  --enable-unicode \
  --with-wx-config=/usr/bin/wx-config-3.0 \
  --with-ssl \
  --with-x \
  STRIP=: \
  DOCBOOK2X_MAN=/usr/bin/db2x_docbook2man \
  "CXXFLAGS=$(pkg-config gtk+-x11-3.0 --cflags --libs) -DNDEBUG"
make 
make install 

Alternatively a specific version (gitbranch and gittag) can be downloaded with the following command:

wget https://github.com/BOINC/boinc/archive/${gitbranch}/boinc-client-${gittag}.tar.gz

Running BOINC using Docker

A Docker image containing the BOINC client can be downloaded from here: https://hub.docker.com/r/boinc/client/

You can run this image using Docker on any 64-bit Intel computer (Linux, FreeBSD, Mac, or Windows).

The image contains only the client. You can control it using a BOINC GUI running locally or remotely.

Using a bootable image

You can download a bootable image containing Linux and the BOINC client, write it to a USB stick, and boot from it. Currently one such image is available: PADOLF@home is based on Debian. It includes the 7.8.3 BOINC client and GUI, and has recent video drivers for AMD and Nvidia GPU support. Note: this is provided by volunteers, not by BOINC.

The Berkeley Installer

The Berkeley installer is available directly from the BOINC project. It is a self-extracting archive. This type of installation requires that you be familiar with the UNIX command-line interface. The download files have names like boinc_7.2.23_i686-pc-linux-gnu.sh.

Here is an example. The archive is downloaded to the desktop. It is then moved to the home directory (~). Finally BOINC is unpacked and installed. All of this can be done within a regular user account; root privileges are not needed.

$ mv ~/Desktop/boinc_7.2.23_i686-pc-linux-gnu.sh ~
$ cd ~ 
$ sh boinc_7.2.23_i686-pc-linux-gnu.sh  

This creates a directory called BOINC/ under the home directory containing the following files:

boinc 
The BOINC core client.
boincmgr 
The BOINC Manager.
boinccmd 
A command line tool for controlling a running core client.
run_client 
A script that cd's into the BOINC directory and runs the core client.
run_manager 
A script that cd's into the BOINC directory and runs the manager.

To start the client manually enter the following terminal commands:

$ cd ~/BOINC  
$ ./run_client --daemon
$ ./run_manager

The BOINC working directory can be moved elsewhere as you like, and can even be renamed. One common choice is ~/.boinc, since files and directories with names that begin with "dot" do not show up by default in Unix directory listings. Whatever the name, everything related to the BOINC client is contained within that directory, and you should always run the client and the manager from that working directory.

Build BOINC from source

You can build the BOINC client from source. Keep in mind that BOINC consists of both client and server software. To run BOINC on your computer you only need to build the client software.

Instructions for building BOINC from source are in a separate developer's wiki. Start with these pages:

There is additional documentation on other web sites:

64 Bit Considerations

If you are running 64 bit Linux, you might have a problem with projects that issue 32 bit applications rather than 64 bit applications. To allow 32 bit applications to run on 64 bit Linux you must install 32 bit versions of certain shared libraries. The names of the packages containing the 32 bit libraries is different for each distro.

N.B. The commands given below are executed in a terminal window. To open, hit the key combination Ctrl+Alt+T. The sudo commands could ask for a password [yours] to temporarily give admin installation rights for the needed libraries. [Default], closing the terminal or leave the terminal idle for 15 minutes will revoke these rights again.

Fedora

Three packages are required for 64 bit compatibility.

Name Description
compat-libstdc++-296.i686 Compatibility 2.96-RH standard C++ libraries
compat-libstdc++-33.i686 Compatibility standard C++ libraries
compat-libstdc++-33.x86_64 Compatibility standard C++ libraries

Install all 3 packages at once, by opening a terminal and typing:

su -c 'yum install compat-libstdc++-296.i686 compat-libstdc++-33.i686 compat-libstdc++-33.x86_64'

Ubuntu

Four packages are required for 64 bit compatibility (Read whole section before applying).

Name Description
ia32-libs description is unavailable
libstdc++6 description is unavailable
libstdc++5 description is unavailable
freeglut3 description is unavailable

Install all 4 packages at once with the following steps:

  1. Open a terminal.
  2. Enter (with a space between every library name, or copy the line as-is, and right-click in terminal to paste)
sudo apt-get install ia32-libs libstdc++6 libstdc++5 freeglut3

If the above fails to get 32 bit work on e.g. World Community Grid or to at all install, these sets work on newer Linuxes [those in italic are optional]

sudo apt-get install gcc-4.7-multilib libstdc++6 libstdc++5 freeglut3 lib32z1 lib32ncurses5 lib32bz2-1.0

or alternate for Test4Theory:

sudo apt-get install gcc-4.7-multilib freeglut3 libwxgtk2.8-dev libcurl4-openssl-dev libxss-dev

The changes will not take effect until the client/daemon has been restarted. This too can be done in terminal, e.g. on Ubuntu with

sudo service boinc-client restart

FreeBSD

  1. go to /usr/ports/net/boinc-client/, open the Makefile in a text editor
  2. change the CONFIGURE_ARGS=--disable-server as follows:
    1. on 32 bit FreeBSD change it to
      CONFIGURE_ARGS=--disable-server --with-boinc-platform=i686-pc-freebsd --with-boinc-alt-platform=i686-pc-linux-gnu
    2. on 64 bit FreeBSD change it to
      CONFIGURE_ARGS=--disable-server --with-boinc-platform=x86_64-pc-freebsd --with-boinc-alt-platform=i686-pc-linux-gnu
  3. do make install clean
  4. if you receive an error like "ELF 0 ....", make sure you have installed
    1. /usr/ports/emulators/linux_base-fc4 or higher
    2. sysctl kern.elf32.fallback_brand=3

There is additional information on installing, configuring and running BOINC on FreeBSD.

OpenBSD

Refer to this page: OpenBSD.