Skip to content

Install SCALE#

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

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

# Replace with your credentials
export CUSTOMER_NAME="<customer-username>"
export CUSTOMER_PASSWORD="<customer-password>"

# Tell apt to authenticate to the repo
sudo tee /etc/apt/auth.conf.d/scale.conf <<EOF
machine nonfree-pkgs.scale-lang.com
login $CUSTOMER_NAME
password $CUSTOMER_PASSWORD
EOF
chmod 700 /etc/apt/auth.conf.d/scale.conf
# Add the scale deb repos.
wget --http-user="$CUSTOMER_NAME" --http-password="$CUSTOMER_PASSWORD" https://nonfree-pkgs.scale-lang.com/$CUSTOMER_NAME/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-unstable

# 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.

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

# Replace with your credentials
export CUSTOMER_NAME="<customer-username>"
export CUSTOMER_PASSWORD="<customer-password>"

# Tell apt to authenticate to the repo
sudo tee /etc/apt/auth.conf.d/scale.conf <<EOF
machine nonfree-pkgs.scale-lang.com
login $CUSTOMER_NAME
password $CUSTOMER_PASSWORD
EOF
chmod 700 /etc/apt/auth.conf.d/scale.conf
# Add the scale deb repos.
wget --http-user="$CUSTOMER_NAME" --http-password="$CUSTOMER_PASSWORD" https://nonfree-pkgs.scale-lang.com/$CUSTOMER_NAME/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-unstable

# 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.

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

# Replace with your credentials
export CUSTOMER_NAME="<customer-username>"
export CUSTOMER_PASSWORD="<customer-password>"

# Add the scale rpm repos.
wget --http-user="$CUSTOMER_NAME" --http-password="$CUSTOMER_PASSWORD" https://nonfree-pkgs.scale-lang.com/$CUSTOMER_NAME/rpm/el9/main/scale-repos.rpm
sudo dnf install ./scale-repos.rpm

# Tell dnf to authenticate to the repo
sudo tee -a /etc/yum.repos.d/scale.repo <<EOF
username = $CUSTOMER_NAME
password = $CUSTOMER_PASSWORD
EOF
chmod 700 /etc/yum.repos.d/scale.repo

Then, install the SCALE package:

# Install SCALE
sudo dnf install scale-unstable

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:

# Replace with your credentials
export CUSTOMER_NAME="<customer-username>"
export CUSTOMER_PASSWORD="<customer-password>"

wget --http-user="$CUSTOMER_NAME" --http-password="$CUSTOMER_PASSWORD" https://nonfree-pkgs.scale-lang.com/$CUSTOMER_NAME/tar/scale-unstable-latest-amd64.tar.xz

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

  • Double-check your credentials are correct, and that both CUSTOMER_NAME and CUSTOMER_PASSWORD are set. If installing with apt, check that /etc/apt/auth.conf.d/scale.conf exists and has the correct credentials. If installing with dnf, check that /etc/yum.repos.d/scale.repo exists and has the correct credentials.

  • 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.