linux_install.php

<?php

// get instructions for installing Linux packages

require_once('../inc/util.inc');

$versions = ['stable'=>'8.0.2', 'alpha'=>'8.0.4', 'nightly'=>'8.1.0'];

function get_oss() {
    $n = 1;
    $oss = [];
    $oss[$n++] = os('Debian', '10', 'buster', 'June 2024', '2.28');
    $oss[$n++] = os('Debian', '11', 'bullseye', 'June 2026', '2.31');
    $oss[$n++] = os('Debian', '12', 'bookworm', 'June 2028', '2.36');
    $oss[$n++] = os('Ubuntu', '20.04', 'focal', 'April 2025', '2.31');
    $oss[$n++] = os('Ubuntu', '22.04', 'jammy', 'April 2027', '2.35');
    $oss[$n++] = os('Ubuntu', '24.04', 'noble', 'April 2034', '2.39');
    $oss[$n++] = os('Fedora', '37', 'fc37', 'November 2023', '2.36');
    $oss[$n++] = os('Fedora', '38', 'fc38', 'May 2024', '2.37');
    $oss[$n++] = os('Fedora', '39', 'fc39', 'November 2024', '2.38');
    $oss[$n++] = os('Fedora', '40', 'fc40', 'May 2025', '2.39');
    $oss[$n++] = os('openSUSE', '15.4', 'suse15_4', 'December 2023', '2.31');
    $oss[$n++] = os('openSUSE', '15.5', 'suse15_5', 'December 2024', '2.37');
    //$oss[$n++] = os('openSUSE', '15.6', 'suse15_6', 'December 2025', '2.37');
    return $oss;
}

function os($type, $ver, $code, $support, $glibc) {
    $x = new StdClass();
    $x->type = $type;
    $x->ver = $ver;
    $x->code = $code;
    $x->support = $support;
    $x->glibc = $glibc;
    return $x;
}

function os_options() {
    $oss = get_oss();
    $x = [];
    foreach ($oss as $num=>$os) {
        $x[] = [$num, sprintf('%s %s', $os->type, $os->ver)];
    }
    return $x;
}

function build_options() {
    global $versions;
    $x = [];
    $x[] = ['stable', sprintf('Stable (version %s)', $versions['stable'])];
    $x[] = ['alpha', sprintf('Alpha (version %s)', $versions['alpha'])];
    $x[] = ['nightly', sprintf('Nightly (BOINC version %s)', $versions['nightly'])];
    return $x;
}

function action() {
    $oss = get_oss();
    $os_num = get_int('os_num');
    $build = get_str('build');
    $os = $oss[$os_num];
    echo sprintf('To install the %s version of BOINC on %s %s:',
        $build, $os->type, $os->ver
    );
    echo '<p>';
    switch ($os->type) {
    case 'Debian':
    case 'Ubuntu':
        echo '<pre>';
        echo sprintf(
'sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 40254C9B29853EA6
sudo apt-add-repository deb https://boinc.berkeley.edu/dl/linux/%s/%s %s main
sudo apt update
sudo apt install boinc-client boinc-manager',
            $build, $os->code, $os->code
        );
        echo '</pre>';
        break;
    case 'Fedora':
        echo '<pre>';
        echo sprintf(
'sudo dnf install dnf-plugins-core
sudo dnf config-manager --add-repo https://boinc.berkeley.edu/dl/linux/%s/%s
sudo dnf config-manager --set-enabled boinc.berkeley.edu_dl_linux_%s_%s
sudo rpm --import https://boinc.berkeley.edu/dl/linux/%s/%s/boinc.gpg
sudo yum install boinc-client boinc-manager',
            $build, $os->code,
            $build, $os->code,
            $build, $os->code
        );
        echo '</pre>';
        break;
    case 'openSUSE':
        echo '<pre>';
        echo sprintf(
'sudo zypper ar -f https://boinc.berkeley.edu/dl/linux/%s/%s official-boinc-repo
sudo zypper install boinc-client boinc-manager',
            $build, $os->code
        );
        echo '</pre>';
        break;
    }
    echo "<p>On headless systems, omit 'boinc-manager'.
        On such systems, the BOINC client can be
        controlled either using <a href=https://boinc.berkeley.edu/wiki/Boinccmd_tool>boinccmd</a>,
        or using a <a href=https://boinc.berkeley.edu/wiki/Controlling_BOINC_remotely>remote GUI</a>.
        <p>
        Details on the installer are <a href=https://github.com/BOINC/boinc/wiki/Linux-installer>here</a>.
    ";

    // GPU instructions
    echo '<h3>GPU computing</h3>';
    echo '<p>
        If the system has a GPU, it may be usable by
        BOINC projects that have GPU-enabled apps.
        On some systems you may need to install
        GPU drivers that support this.
        <p>
        Check the BOINC client\'s output on startup.
        It should detect your GPU (NVIDIA, AMD, or Intel) using OpenCL,
        and NVIDIA GPUs should also be detected using CUDA.
        If not, check whether updated drivers are available
        for your GPU type and Linux distro.
        In general, vendor-supplied drivers may be
        preferable to open-source drivers.
    ';

    // attach instructions

    echo '<h3>Configuration</h3>
        <p>
        You must tell BOINC which science projects to compute for.
        The recommended way is to use Science United,
        where you choose science areas rather than individual projects.
        <ul>
        <li> <a href=https://scienceunited.org>Create an account</a>
            on Science United.
        <li> <a href=https://scienceunited.org/su_help.php>Attach this computer</a> to the Science United account.
        </ul>
        <p>
        You can configure BOINC to limit its
        computing, memory usage, and disk usage.
        Do this using the BOINC Manager
        (Options / Computing Preferences)
        or the Computing Preferences form
        on the Science United website.
    ';

    // uninstall instructions
    echo '<h3>Uninstall</h3>
        <p>
        To remove BOINC:
    ';
    switch ($os->type) {
    case 'Debian':
    case 'Ubuntu':
        echo '<pre>sudo apt remove boinc-client boinc-manager</pre>';
        break;
    case 'Fedora':
        echo '<pre>sudo yum remove boinc-client boinc-manager</pre>';
        break;
    case 'openSUSE':
        echo '<pre>sudo zypper remove boinc-client boinc-manager</pre>';
        break;
    }
}

function main() {
    $os_num = get_int('os_num', true);
    $build = get_str('build', true);
    page_head('Installing BOINC on Linux');
    text_start(800);
    echo "<p>
        The recommended way to install BOINC on a Linux system
        is as a package.
        Get instructions using this form:
    ";
    form_start('linux_install.php');
    form_select('Operating system', 'os_num', os_options(), $os_num);
    form_select(
        'BOINC build<br><font size=-1>
            Stable: recommended version
            <br>Alpha: version under test
            <br>Nightly: very latest version</font>',
        'build', build_options(), $build
    );
    form_submit('Get instructions');
    form_end();

    if ($os_num) {
        action();
    }
    text_end();
    page_tail();
}

main();

?>