How to setup your servers on Pterodactyl

Gaining access to the panel

Once you've purchased a dedicated server and selected to install Pterodactyl, you may be unsure on how to get started so we will learn the first steps on getting started with your server. Please note before we get started, you need to wait until the email titled "Your server's new login credentials" is sent, this contains the important data we will need and lets us know the install has completed.

After receiving the email, you want to make sure you keep the Admin Password safe and stored somewhere, our support team may require this in order to assist with an enquiry. Once you've stored the password, you will want to wait roughly 20-30 minutes for the Pterodactyl install to complete, if you go to the link and nothing loads after waiting that time, please contact us so we can take a look into why. If everything has worked, you should find a page similar to this.



This will show you the admin details to login to the panel afterwards, again, keep these details safe as without them, you won't be able to access your panel and configure your servers.

After saving the details, click the "Go to Panel" button to take you to your servers panel for the first time. Then enter the details you were given and we can now enter our panel!

You won't notice too much currently, but this is what the next part is for!

Creating your first server

Now we are in, you may wonder, well how do I actually run a server from here? Well, this is exactly what we're going to do here, we will setup and create our first server for you. Please note, all of these settings can be changed even after the server has been created, so it isn't the end of the world!

The first step is getting to the admin side of the panel, since the first account is an admin account, we can do as we wish in the panel in a secret menu. To get to this menu, just click the little ⚙️ in the top right.

Once in the admin panel, the next step is quite simple, just click the servers tab down the left hand side and we can see a button to create a new server, click that and now we are ready to create our first server.

This may look like a lot of information, but once we get into it and explain each setting, you will be able to create as many servers as you want!

Core Details

This is the section where we fill out the details about who owns the server, what it should be called and a brief description so we can easily find it later on, here is a list of the options and how to fill them out:

Server Name: This is the name you want to call it, it must be alphanumeric with the exceptions of spaces, underscores, hyphens and dots. An example would be "SMP"

Server Description: This is just a small description about what will be run on the server used to identify it, an example would be "A server for me and my friends to play on"

Server Owner: To start with, you will only have one user added to the panel, that is the account you're logged into. By default, this has an email address of user@example.com. Enter this email address if you've just started, otherwise enter the email address of the user you would like to own the server.

Allocation Management

Unless you're super advanced at using Pterodactyl ( at that point, I am sure you wouldn't need this guide anyway ), there is only really one option that matters here which is the default allocation, netherless we will still explain what they are all for:

Node: This setting is not something to worry about realistically, this is mainly if you had 2 dedicated servers linked to the same panel, you can select which machine to place the server on. If you only have one machine, just leave it as the default setting.

Default Allocation: This will become the primary IP and Port to access your server so it's important you choose right. When we install the panel, we add some common ports for you to get you started. If ones in the list don't suit you, contact our support team and we can show you how to add more! One thing to note is you may see some IP and Ports that start with 127.0.0.1, these aren't something you should use normally, these are primarily allocations which you should select if you're creating a server for the backend of a Bungeecord network, these allocations stop an exploit known as UUID Spoofing by blocking connections from the public. If you're not doing the above, choose one of the ones with a 5 digit port and you are good to go.

Additional Allocation(s): This setting is used if you wanted a second port for your server, common uses would be ports for Dynmap. If you need ports for Dynmap or such, just select an allocation that as a 4 digit port such as 8000, otherwise leave it blank.

Application Feature Limits

These are settings to allow you to configure what you can create on your server without being an admin on the panel including databases and backups.

Database Limit: This is how many databases that can be created on the server, normally 1 is enough since you can connect multiple plugins to the same database as long as they have different table names

Allocation Limit: This setting probably won't affect you, it allows users on the panel to create their own allocations without being an admin on the panel, probably best to leave this as 0.

Backup Limit: This configures how many backups per server can be created at one time, a good setting is usually 3. Please be careful, backups take up a lot of storage and making too many may use all your disk usage up and start corrupting your servers, its definitely something to keep an eye on.

Resource Management

These are settings that are used to determine things like how much memory each server can use and more like that, we will explain each setting as we go.

CPU Limit: This is where we can specify how many threads each server can use. If your system had 8 threads, the maximum a server could use is 800%, this doesn't stop the other servers from using these threads it is just how many threads can this server use. If you don't want to set a limit, enter 0 as this is unlimited and likely the best option.

CPU Pinning: This is an advanced option, most of you will want to leave it blank. This allows you to only let a server use specific CPU threads, if you had 8 threads, the numbers are 0-7 for you to enable. This could allow you to set one server to use threads 0-3 only and another 4-7 only if you really wished.

Memory: This is the maximum amount of memory the server can use, although you can enter 0, this will break JVM ( the Java Virtual Machine ) which is used to launch Minecraft servers, our advice is to give it a proper limit, the server can exceed this as we will explain it further down. Please enter it in MB.

Swap: This setting is actually disabled by default regardless so you won't be able to use it. Just in case you're intrigued, it essentially allows some memory of the server to be located on the machines disk drive, this tends to be a lot slower due to the access times but if you're running out of memory, it can be useful in small quantities, too much would hinder the servers performance massively.

Disk Space: This is the maximum amount of disk usage the server can use in MB, the recommended setting we suggest is 0 as this means that you can use as much as you want.

Block IO Weight: This allows you to determine the weighting of which server gets priority disk usage. This is a very advanced setting and best to leave it at 500 for now, otherwise it needs be between 10 and 1000.

Enable OOM Killer: This essentially kills the server as soon as it exceeds its memory limits, your best option is to leave it off, if your server goes over the maximum memory, you normally don't want it to instantly shut down.

Nest Configuration

This is a very powerful system in Pterodactyl in which it allows you to setup and run different servers, all the way from Minecraft to servers for games such as ARK or Terraria, there are also many more.

Nest: This is the group for what the server should be running, you have Minecraft for Minecraft related servers and ones such as Source Engine for games such as Ark. I'd suggest you take a look at each of the eggs for each Nest to find what you want to run.

Egg: This is the actual server type your server will run, it's important to get this right the first time as changing it later can be a little difficult.

Skip Egg Install Script: This is just if you wanted to install the server manually, it's best to leave this unchecked as the Egg's are there for a reason, to install the server.

Docker Configuration

This is a very advanced setting and not normally something you want to edit. It allows you to select different Java versions or such that will run on your server and similar settings. One thing to note, if you plan to run the latest version of Minecraft, you'll need to switch it to ghcr.io/pterodactyl/yolks:java_16

Startup Configuration and Service Variables

These are settings that are primarily used for each Egg, such as Minecraft or Ark, there isn't much really to say about these settings for now, it's best to leave them all default. We can edit these settings after the server is created from the user side of the panel.

Now, just hit Create Server and you will see the server begins installing. Keep checking/refreshing until you see the server has finished its install from the admin side, different eggs have longer times, for example ARK can take up to 20 minutes.

After the install has finished, click the small icon in the top right with the box and arrow to it, this will take you to the servers page for the first time, where you can start, see the files and much more.

A brief overview of the server page

Now that we have our server created, let's go through all the different tabs and what they are used for.

From the panels homepage, select the server you want to view.

This is what you should see, with all the different tabs at the top.

Console: This is where you can manage your servers power controls by stopping, starting or restarting it. It allows you to see the resource usage and run commands to console/view its output

File Manager: This is where you can see all current files on the server, delete, edit and download them as you wish.

Databases: This is where you can create databases as mentioned earlier, you can use this to connect plugins across servers together or a way to store data.

Schedules: This is where you can setup automated tasks for your server to run whenever you choose, we will spend a little bit of time explaining this, as it can get a little confusing if you're not used to it.

The idea is simple, first create a new schedule, each schedule should be created for a specific task. This includes things such as restarting a server, taking backups and more. You specify the time that each task should run and how long, then each task has its own set of commands to run after certain time constraints. For restarting a server, you could say after 0 seconds, run the command "say Server restarting in one minute", then create a second command that is a power action after one minute, to restart the server. Here's an example restart schedule that will restart twice every day at 6am and 6pm:



The * means we will at everything, so * means we will run in every month, every day of the week and every day of the month. Everything must be entered in numbers so if we wanted to only run in February, we would enter 2 in the month box, we can specify multiple values like we have done for hours by separating with commas or just enter one value as with minutes.

Once the schedule is created, click on it to edit it where we can our tasks, it also helps you by telling you the next run to ensure you've done it right. This is our schedule with our tasks added.



One last thing to note, is if you set the action to create a backup, it will delete the oldest backup if you've reached your backup limits.

Users: This is where you can add another user to have access to a server without being an admin on the panel. To do this, press the new user button, enter their email address and select the permissions you want to do and then press Invite. Now, unless you've setup a mail server and set pterodactyl to use it, they won't actually get an email. Instead, head to the admin panel, head to the Users tab now in the admin panel and manually set a password for the email, then forward this to the user.

Backups: This is where you can manually create backups, download or delete the backups for each server.

Network: You won't have too many uses for this page, this is mainly for setting the primary port for your server and seeing what ports the server can use.

Startup: This is where you can change things relating to the startup of the server, for example this might be the server password for the ARK server or the name of the jar file for a server. For example, if you uploaded a custom jar file for your server in the file manager, you would then change Server Jar File to the name of the custom jar and restart.

Settings: This is where you can find the details required to access your server from an FTP client such as FileZilla. You can also change the server name and reinstall it. Reinstalling it is a very dangerous option as you may lose some data or some unexpected changes so be careful using this.

Hopefully, you should now be almost an expert at creating and managing your servers on Pterodactyl. If you have any further questions, please feel free to contact our support team at any point regarding questions you may have.
Was this article helpful?
Cancel
Thank you!