2. Installation and Setup

The Belle II Software is meant to work on any recent 64 bit Linux system but it is only tested and provided in binary form for a few select distributions

• Enterprise Linux 7 or CentOS 7 (el7)

• Enterprise Linux 8 or CentOS 8 (el8)

• Enterprise Linux 9 or AlmaLinux 9 (el9)

• Ubuntu 20.04 (ubuntu2004)

• Ubuntu 22.04 (ubuntu2204)

If you run on one of these distributions the most convenient way to obtain the Belle II Software is to use it via CVMFS, which is readily available on KEKCC and many HEP specific software resources. It can also easily be installed on your local machine following the CVMFS Client Quick Start guide.

Note

In the following it is assumed that you have configured your access to the code repository

If you have CVMFS available, please continue with

• 2.1. Setup of the Belle II Software

If you want to install the Belle II Software without CVMFS please have a look at the following documents:

• 2.2. Belle II Software Tools
• 2.3. Local Installation

Alternatively you can use a docker container to get the Belle II software (instructions here), for example on Mac or Windows machines.

If you want to use the Belle II software in a virtual environment, please have a look at the b2venv documentation.

• 2.4. b2venv: Using basf2 in a virtual environment
• 2.5. Upgrading Python packages in the virtual environment