Troubleshooting

What to check when your server will not start, keeps crashing, runs out of memory or disk, or cannot use its port.

Most problems can be diagnosed from three places in the panel: the Console (what the game and the panel say), Activity (what happened and when) and Settings (your limits). Start there before anything else.

The server will not start

Read the console

Press Start on the Console and read from the top. The panel prints its own steps first, with the prefix [pelican Daemon]: it checks the disk usage, updates the process configuration, makes sure the file permissions are right and pulls the game image. The first start can say Pulling Docker container image, this could take a few minutes to complete.... Wait for Finished pulling Docker container image.

Find the game's own error

After those lines, the game prints its output. The last lines before the server goes Offline are usually the reason. Search them for error, failed or a file name.

For example, a FiveM server without a licence key prints:

This server does not have a license key specified. Please set the sv_licenseKey console variable to a key from https://portal.cfx.re/servers/registration-keys.

and then the panel reports it as a crash. Add the key to server.cfg (sv_licenseKey "...") in the File manager, or run the server with txAdmin, see FiveM and the Enable txadmin variable in Startup.

Check the last things that changed

Open Activity. If the problem began after someone changed a variable or a file, undo that change. A wrong Docker Image in Startup is a common cause: set it back to Default.

If a server starts and is stopped by the panel again and again, see the next section.

The server stops or restarts by itself

When the game process exits without you stopping it, the panel logs a crash report in the console:

---------- Detected server process in a crashed state! ----------
Exit code: 143
Out of memory: false
Aborting automatic restart, last crash occurred less than 60 seconds ago.
  • Exit code is the code the game finished with.
  • Out of memory tells you whether the game was stopped for using more memory than your plan has. It said false in this example.
  • Aborting automatic restart, last crash occurred less than 60 seconds ago means the panel does not keep restarting a server that crashes straight away. Fix the cause, then press Start yourself.

Each crash is also recorded in Activity as Server crashed with the user System.

Out of memory

If Out of memory says true, or the server dies as soon as players join or a big map or resource loads:

  1. Look at the Memory box and the Memory graph on the Console and compare them with the limit of your plan (Settings, Limits, Memory). If the line goes up to the limit before the crash, the game needs more memory.
  2. Remove what you do not use (plugins, resources, mods, a big map) and restart.
  3. If the game really needs more, upgrade the plan.

The disk is full

The Disk box on the Console shows the used space and the limit of your plan, for example 278.71 MiB / 5.00 GiB. The panel also checks the disk usage every time the server starts. When the server is full, the game cannot save worlds, logs or databases and may crash or refuse to start.

Find what is big

Open Files. The Size column shows folders and files, and Nested Search helps you find big ones. Logs, caches, old archives and backups you downloaded are the usual suspects.

Remove what you do not need

Delete old logs and archives. Select several rows and use Bulk actions, then Delete selected. Download anything you want to keep first, over SFTP for big files.

Start the server again

Check the Disk box and start the server. If you keep hitting the limit, upgrade the plan.

The port is in use or players cannot connect

Your server can only use the ports assigned to it. They are in Network.

  1. In the game's configuration use the primary port shown on Network. Another port, or the default of the game, is not assigned to your server.
  2. If you need an extra port, for example for a second service, ask support, see Network.
  3. Give players the Address shown on the Console, the hostname and the port.
  4. If the console says the server is running but players cannot join, check whether the game needs a licence key, a password or a whitelist, see FiveM, Minecraft and MTA:SA.

The Start button does not work

  • The server may already be starting. Look at Status on the Console. While it is Starting you get Kill instead of Stop.
  • You may not have the permission. If someone gave you access, ask the owner for Start, Stop and Restart in the Control group, see Users.

I cannot sign in to the panel

See Panel access: use Forgot password? and check you are not using the Billing Panel or Virtualizor password.

Still stuck?

Contact support with the service number, the Server ID (in Settings), what you tried and the last lines of the console, see Getting support.