Skip to content

Install SCALE#

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

First, add ROCM 6.3.1's package repositories, as per AMD's instructions. Then, add our repository and install from it.

# 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

# Install SCALE
sudo apt update && sudo apt install scale-free

# Add your user to the `video` group:
sudo usermod -a -G video $(whoami)

If you did not already have the amdgpu-dkms kernel driver installed prior to installing SCALE, you should now reboot.

First, add ROCM 6.3.1's package repositories, as per AMD's instructions. Then, add our repository and install from it.

# 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

# Install SCALE
sudo apt update && sudo apt install scale-free

# Add your user to the `video` group:
sudo usermod -a -G video $(whoami)

If you did not already have the amdgpu-dkms kernel driver installed prior to installing SCALE, you should now reboot.

First, add ROCM 6.3.1's package repositories, as per AMD's instructions. Then, add our repository and install from it.

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

# Install SCALE
sudo dnf install scale-free

If you did not already have the amdgpu-dkms kernel driver installed prior to installing SCALE, you should now reboot.

Download and extract the SCALE tarball:

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

# Extract it to the current directory
tar xf scale-free-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.

Troubleshooting#

These issues relate to installation specifically. For more general troubleshooting steps, see here.

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.