User:Asoftbird/sandbox serversetupguidev2

From GT New Horizons
Under construction. Intended to replace the Oracle Cloud guide section on the current server setup page. Asoftbird (talk) 12:06, 13 December 2023 (UTC)

The general setup for Linux is - get a server. Get SSH access to the server. Make sure Java 17+ is installed. Download the latest server pack from (Use the version, which will work with Java 21. Unzip the server pack and run


  • This guide was written for Ubuntu Server 22.04. It should be compatible with most other common Linux operating systems, but this has not yet been tested on other operating systems.
  • Setting up a server using Linux is a bit more advanced than through Windows; it requires a Linux server (rented or otherwise) and all interaction with the server is done through a SSH terminal connection. There will be no fancy GUI, just a text-only terminal. Nevertheless, this guide will attempt to cover the entire process of installing a GTNH server in a way where non-techsavy people can hopefully understand it. To aid you in this, several script files are provided to automatically execute installation commands so you don't have to.

If you're already familiar with Linux operating systems, you can skip [straight to the GTNH installation chapter].


This structure of this guide is as follows:

  • Getting a server
  • Connecting to the server
  • Server setup
  • Starting and stopping the server
  • Server backups
  • FAQ (Frequently Asked Questions)

Getting a server

Listing places where servers can be rented is outside the scope of this guide. However, as long as you've got a Linux server with good enough hardware (editor note: what are the hardware requirements?) and SSH access to that server, you're probably good to go.

If you would like to set up a Linux server using the free Oracle Cloud service, a [setup guide can be found here].

Connecting to the server

When renting a server, you will usually be provided with an IP address for the server, a server username, and a password. You will need these to connect to the server using the SSH protocol. For this, we will be using the SSH client PuTTY. PuTTY can be downloaded from here..

Note: While SSH is included with the Windows Command Prompt, it lacks essential functionality such as tab autocomplete. Instead, PuTTY is used to make the terminal experience a little bit smoother.

After installing and opening PuTTY, you will be presented with an interface that looks like this.

You can safely ignore most of the settings here; the only thing that matters is the "Host Name (or IP address)" field. This is where you'll need to type the IP address of your server. Click "Open" at the bottom to attempt to connect to your server.

If everything goes well, a black terminal will open; this is how you will manage your server.

Note: If the terminal is instead empty, a connection could not be made. Check if you typed the server IP address correctly and if the server is actually running.