Install the Gala Node Software on an Ubuntu Linux VPS
If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.
This article is a step-by-step guide to install a Gala Node on an Ubuntu Linux (20.04) VPS.
Gala Nodes such as a Founder’s Node or a Town Node are an important component in the Gala Games Ecosystem. Running a Node on a stable Operating System can help ensure consistent uptime. While there are both Windows and Mac options, Linux is able to run the Gala Node software in a more stable and less resource intensive environment. This guide provides instructions on how to install the Gala Node software on a Linux Virtual Private Server (VPS) as long as an account has a valid node license.
This is a more advanced tutorial compared to running the Gala Node software on Windows or MacOS. This is only recommended to people who are already familiar with Linux. If there are any issues running the script, seen below in the step-by-step guide, please check in our founders-nodes channel in Discord at www.galagames.chat.
This article assumes the reader understands the information in the following articles:
To begin, a Gala Node owner will need the following:
-Ubuntu Linux VPS instance running Ubuntu 20.04 . Running other versions may cause issues with the script (In this example we will be using a VPS purchased from Vultr)
1) After logging into Vultr account, click Products.
2) Then click on the + sign in the top right corner and select Deploy New Server.
3) On the next page ensure Cloud Compute is selected.
4) Scrolling down the webpage will allow a user to select a Server Location where the VPS will run. It is best to pick a location nearer to where a person is remoting from, as this will decrease latency (lag) between the server and the remote computer. This example will use the Atlanta server in the United States.
Note: If creating multiple Gala Node VPS, it is best to spread the servers to different server locations. This helps with ensuring that if a server location goes down, all of the Gala Nodes a person is running are not having issues at the same time.
5) Scroll down to Server Type and select Ubuntu 20.04 x64 . For best compatibility, please use the version of Ubuntu Linux as shown in this guide.
6) Select the Server Size, please see Gala Node Requirements for more information.
Note: The Gala Node software does NOT work with IPv6, please do not select an IPv6 only server, and that IPv6 is NOT enabled. The below screenshot is from an IPv6 enabled server.
7) Continue scrolling down and enter in a name for the Server Hostname and Server Label. This example will use the name listed below. If running more than 1 Gala Node, it may be beneficial to name each one with a number at the end. This will make it easier to identify.
8) At the bottom of the webpage, click Deploy Now.
9) The website will be redirected to the Products page. This will show the Status of the server as installing.
Once the server finishes installation, it will change to Running. When this happens, click on the server as shown in the image below. This will then show the Server Details page.
10) On the next page, it will show everything required to login to your server.
IP Address: The address needed to connect to the VPS.
Username: The name of the user required to log into the computer.
Password: The password needed to log into the server to perform actions on the server.
Installing The Gala Node
1) Open up PuTTy (or another Terminal Console Application) and enter the IP address given by Vultr. After typing it in click Open as shown in the below screenshot.
1a) This prompt may appear when first logging into a Vultr VPS using Putty. This is normal, click Yes to continue. After the first time this prompt is shown, it will no longer appear after remoting into the computer.
2) Type in the default login, in this case it is root. Press Enter on the keyboard to continue.
3) Then enter root’s password that is shown on the Server Details page.
Note: To paste your password, right-click to paste.
Note: PuTTy will not provide feedback when typing a password. Enter the password and hit Enter, if it is entered incorrectly it will show an "Access Denied" message.
4) The next step will download the Gala Node software package.
Note: First run this script: sudo apt-get update && sudo apt-get upgrade -y
Next type in:
wget -O install-headless.sh https://static.gala.games/node/install-headless.sh; sudo bash install-headless.sh
Hit Enter. If using Putty, it will allow a user to paste the script instead of requiring a person to type it in.
5) The script will show this below, select Yes with the keyboard (use the left and right arrows on the keyboard) and press Enter to continue the setup.
6) The installation script will automatically start the Gala Node installation. Once the required files are installed, users will need to navigate to the activation page to sign into their Gala Node Software.
Users can copy this info in putty by highlighting the link fully and it will copy it into the user's clipboard automatically. Users will then be able to put this link into a web browser of their choice.
7) A device confirmation code will appear in the web browser.
Make sure that the code in the web browser matches the same code shown in the putty window.
If the code is show correctly, click Confirm.
Note: If a user hasn't logged into their Gala Games account previously, a login page will appear. Enter the credentials needed to log into the desired Gala Games account and click continue.
If done successfully, the prompt below will appear in the web browser.
8) After confirming the Gala Node login credentials, the workload selector page will appear. Select all workloads desired and click Save.
Once this is complete select exit and the installation finished prompt will appear.
9) It will show the Gala Node is active. NOTE: Active does not reflect if a password is entered incorrectly. See instructions below to make sure your Node is active.
10) After finishing the Gala Node setup, log into the same Gala Games account used in the Gala Node setup and navigate to the Account page.
11) In the Settings page, click Node Info.
12) On the Node Info page it will show how many licenses this account has, as well as how many nodes are online. Since this shows 1 node is online, this means that the password was entered correctly and the network can now see the Gala Node operating on Vultr. Repeat steps 1 - 11 for any remaining Node licenses since every Gala Node needs a separate computer running it.
12a) If the node online shows 0 after creating the first Gala Node, this means the password was not entered correctly. This will require the server to be reinstalled so the script can run with a clean slate. In the Server Details page, click Server Reinstall as shown in the screenshot.
12b) Check Yes, reinstall this server and then click Reinstall Server. This deletes the information on the server so it is a fresh install.
Once this is complete, follow the steps to install a Gala Node again.