Mac Windows Linux Other

Installing OSCAR 1.7.2 on Linux

🛠️ Already have OSCAR? Upgrade to the latest version here.

Follow the steps below to install OSCAR v1.7.2. Basic familiarity with using a terminal is assumed.

Having trouble? Visit our Contact & Support page for help.

WARNING: The installation process of OSCAR, particularly the precompilation step, requires at least 6GB of free memory. For optimal performance, we recommend having at least 16GB of RAM.

Step 1: Install prerequisites

Run the following commands in a terminal. You may be prompted for your root password and need administrative privileges.

Ubuntu (20.04 “Focal” or newer) / Debian (11 “Bullseye” or newer)

sudo apt update
sudo apt install build-essential

Fedora (40 or newer)

sudo dnf install gcc-c++ make

Step 2: Install Julia

WARNING: Linux users should generally not install Julia via their package manager (e.g. apt, pacman, dnf), as these versions are often outdated, or crippled, or both.

OSCAR requires Julia 1.10 or higher. We recommend installing the latest stable release of Julia by entering the following in a terminal and heeding the instructions it shows:

curl -fsSL https://install.julialang.org | sh

Step 3: Install OSCAR

Open the Julia REPL in your terminal by typing the following:
```
julia
```
Install OSCAR by running the following commands. This may take a while, as OSCAR and its dependencies will be downloaded and installed.
```
using Pkg
Pkg.add("Oscar")
```

Step 4: Start OSCAR

Run using Oscar in the Julia REPL:

julia> using Oscar
  ___   ___   ___    _    ____
 / _ \ / __\ / __\  / \  |  _ \  | Combining and extending ANTIC, GAP,
| |_| |\__ \| |__  / ^ \ |  ´ /  | Polymake and Singular
 \___/ \___/ \___//_/ \_\|_|\_\  | Type "?Oscar" for more information
o--------o-----o-----o--------o  | Documentation: https://docs.oscar-system.org
  S Y M B O L I C   T O O L S    | Version 1.7.2

Optional: Running Tutorials Locally with IJulia

If you would like to run the OSCAR tutorials locally, you can do so using IJulia.

Install IJulia (and Jupyter) by running the following command inside your Julia REPL:
```
using Pkg; Pkg.add("IJulia")
```
For more details, see the IJulia installation guide. If you encounter issues, you may need to explicitly build IJulia. Troubleshooting information is available on the IJulia troubleshooting page.
Download one of the OSCAR tutorials.
Start Jupyter by running the following in your Julia REPL:
```
using IJulia; notebook()
```
Your web browser should open the Jupyter interface. In the upper-left corner you should see “Jupyter”; the file explorer appears below it. Locate and open the tutorial notebook you downloaded. If you see a message such as Kernel not found or Kernel error, select a different Julia kernel in the top-right corner of the notebook.