Skip to main content

Install a Jukebox Node on Ubuntu Linux

  • Published .
  • Updated .

Purpose

This article is a step-by-step guide to installing Gala Node software on Ubuntu Linux (version 20.04). The Gala Node software will allow users to run their Jukebox Node workload. Running the Gala Node software on a stable Operating System can help ensure consistent uptime.

This tutorial is more advanced than running the Gala Node software on Windows or macOS. This is only recommended to people who are already familiar with Linux. If any issues are running the script, as seen in the step-by-step guide below, please check the node-talk channel in Discord at www.galagames.chat.

Assumptions Made

Procedure

Installing The Gala Node Software

1) Open the Terminal for the Ubuntu installation and enter:


sudo NEEDRESTARTMODE=a apt update && sudo apt upgrade -y
   
This will ensure that the computer has the latest package list for installing programs.
   
2) Enter:

sudo apt install docker.io -y
   
This command will install a program called docker. Docker is important for running workloads in the Gala Node software.
   
3) After running the installation, enter this command to see docker’s status.
   
sudo systemctl status docker

 

Press q or CTRL + C and Enter to exit the Docker Status Menu.

If docker is not in active status, use this command to start it.

sudo systemctl enable --now docker

4) Enter this command below to download the Gala Node software for Linux.

sudo wget --trust-server-names https://links.gala.com/DownloadLinuxNode

 

It downloads a file name called gala-node-vX.X.X.tar.gz.

5) After downloading, run the command below to extract the Gala Node software. Ensure to update the [version number] based on what version they download. Please see the screenshot highlighted below to find the software's version number. 

sudo tar xzvf gala-node-v3[version number].tar.gz

Example: sudo tar xzvf gala-node-v3.1.10.tar.gz

 

6) This next command runs the installation script for the Gala Node software.

sudo ./gala-node/install.sh

Read the End User License Agreement, Type Y, and press Enter to accept and proceed with the installation.

 

7) After successfully installing the Gala Node software, an API key is needed to access a user’s Gala Games and Entertainment account and pull up the available workloads. Please read the Gala Node Dashboard article for creating an API key. This API key will be used in the following command:

sudo gala-node config api-key 

your API key here

Example: sudo gala-node config api-key qmlQZxDDQWERTYhwwrpfUWv8n2wE+XoGADnUWpDIVoI=

8) After entering the account’s API key, run this command to see the currently available workloads available.

sudo gala-node licenses 

 

 

Make sure you see player to ensure that you have a jukebox license.

9) Use this command to add a jukebox workload to your computer.

sudo gala-node workload add player

If you want multiple workloads on one computer, enter the command for each type of workload individually.

 

10) Once the configuration is complete, run this command to start the Gala Node software.

sudo gala-node start 

 

 

11) Now that the Gala Node software installation is complete run this command to ensure the software is running properly. 

sudo gala-node status 

 

 

Note: It may take up to 10 minutes for this node’s status to reflect on a user’s Gala Node Dashboard.

Optional: 

Run sudo gala-node rename to name your node so you can identify your node on the dashboard.

Visit Linux Gala Node Software Commands to learn more about the available commands to manage the Gala Node software.

12) After the node appears in the Gala Node Dashboard, activate your Jukebox Node (Player Node on the Gala Music website if you haven't already. Skipping activating your Jukebox Node will cause your music workload to go offline and you won't receive rewards.