Skip to content

Install SCALE#

Select your operating system and version below to see installation instructions.

You can also use SCALE with Docker.

No root access? Use the tarball distribution.

Set up the SCALE repository, if you haven't already:

# Add the scale deb repos.
wget https://pkgs.scale-lang.com/deb/dists/jammy/main/binary-all/scale-repos.deb

sudo apt install ./scale-repos.deb

# Update package list
sudo apt update

Then, install the SCALE package:

sudo apt install scale

Set up the SCALE repository, if you haven't already:

# Add the scale deb repos.
wget https://pkgs.scale-lang.com/deb/dists/noble/main/binary-all/scale-repos.deb

sudo apt install ./scale-repos.deb

# Update package list
sudo apt update

Then, install the SCALE package:

sudo apt install scale

Set up the SCALE repository, if you haven't already:

# Add the scale rpm repos.
sudo dnf install https://pkgs.scale-lang.com/rpm/el9/main/scale-repos.rpm

Then, install the SCALE package:

# Install SCALE
sudo dnf install scale

Download and extract the SCALE tarball:

# Download the tarball
wget https://pkgs.scale-lang.com/tar/scale-latest-amd64.tar.xz

# Extract it to the current directory
tar xf scale-latest-amd64.tar.xz

The tarball is significantly larger than other options since it includes many dependent libraries directly instead of asking the system package manager to install them.

Post-installation steps#

Ensure that your user can access your GPU:

sudo usermod -a -G render,video $LOGNAME

You may also need to restart for all changes to apply, especially if you have just installed or updated the AMDGPU kernel module.

Installation Troubleshooting#

I'm not able to set up the SCALE repository#

  • To follow the installation instructions above, you will need to install wget and tar. This is installed by default on many systems, and usually available in your system package manager otherwise.

  • If you're still unable to download the repository setup package (scale-repos.deb / scale-repos.rpm), check your internet connection.

  • If you're unable to install the repository setup package, you may have manually added the repository previously. If so, these files can be safely overwritten when prompted by your package manager.

AMD's kernel modules are only supported on certain kernels. If your system uses a very out of date kernel, you may need to upgrade it in order to build it correctly.

I get file conflicts when installing the SCALE package#

This is usually caused by a previous manual installation of SCALE, or a different version of SCALE installed on the same system. Currently, only one version of SCALE and its associated ROCM version can be installed at once.

I previously had your repositories set up, but it broke mysteriously.#

We recently merged our stable and unstable repos. This shouldn't require any action for our users, but if you're having troubles then we suggest completely removing our repositories and adding them again:

# On Rocky
sudo dnf remove 'scale-repos*'
sudo rm -f /etc/yum.repos.d/scale.repo

# On Ubuntu
sudo apt-get remove 'scale-repos*'
sudo rm -f /etc/apt/sources.list.d/scale.list /etc/apt/auth.conf.d/scale.conf

# Then follow the instructions above again.

I'm still stuck!#

Get help.