Skip to main content
Network servers are the physical or virtual machines that host your game servers. GamePanelX V3 supports both local servers (running on the same machine as the master) and remote servers (controlled via SSH).

​
Network Server Overview

The Network page displays all configured network servers:
ColumnDescription
TypeLocal or Remote server
IPServer IP address
OSOperating system
LocationPhysical or logical location
DatacenterDatacenter or provider name
ManageEdit server settings
You must configure at least one network server before you can create game servers or templates.

​
Server Types

Local Server

The same machine where GamePanelX master is installed. No SSH connection required.

Remote Server

A separate machine controlled via SSH. Requires GamePanelX remote server files to be installed.

​
Adding a Network Server

1

Access Add Network Form

Navigate to Network > Add Network Server
2

Basic Information

Enter server details:
  • IP Address: Server’s public or private IP
  • Type: Select Local or Remote Server
  • Location: Physical location (e.g., “New York, USA”)
  • OS: Operating system (e.g., “Ubuntu 20.04 LTS”)
  • Datacenter: Provider or datacenter name (e.g., “DigitalOcean NYC3”)
3

Remote Server Configuration

If Remote Server is selected, provide SSH credentials:
  • Login User: SSH username (must have appropriate permissions)
  • Login Password: SSH password
  • Login Port: SSH port (default: 22)
4

Save Configuration

Click “Add” to create the network server entry

​
Local Server Setup

Type: Local Server
IP: 192.168.1.100
Location: On-Premises
OS: Ubuntu 22.04 LTS
Datacenter: Local Datacenter
Local servers do not require SSH credentials as GamePanelX executes commands directly on the local system.

​
Remote Server Setup

Type: Remote Server
IP: 203.0.113.50
Location: Los Angeles, USA
OS: Debian 11
Datacenter: Linode LA
Login User: gameservers
Login Password: ********
Login Port: 22
Before adding a remote server, you must install the GamePanelX Remote Server files on the target machine. Download these from gamepanelx.com and follow the remote server installation guide.

​
Remote Server Requirements

​
Prerequisites

Remote servers must have:
  • Linux operating system (Ubuntu, Debian, CentOS, etc.)
  • SSH server running
  • GamePanelX Remote Server scripts installed
  • Screen utility installed
  • Sufficient disk space for game server files
  • Required game server dependencies

​
SSH User Permissions

The SSH user specified must have:
  • Read/write permissions to the game server directory
  • Ability to execute GamePanelX remote scripts
  • Permission to create and manage screen sessions
For security, create a dedicated user for GamePanelX operations rather than using root.

​
Installing Remote Server Files

  1. Download GamePanelX Remote Server package
  2. Extract to the remote server
  3. Run the installation script
  4. Configure permissions
  5. Test connectivity from the master server
# Example remote server setup
sudo useradd -m -s /bin/bash gameservers
sudo su - gameservers
wget http://gamepanelx.com/remote/gpx-remote-latest.tar.gz
tar -xzf gpx-remote-latest.tar.gz
cd gpx-remote
./install.sh

​
Editing Network Servers

Click any network server to modify its configuration:
1

Update Server Details

Modify IP, location, OS, or datacenter information as needed.
2

Change Server Type

Convert between Local and Remote server types if required.
3

Update SSH Credentials

For remote servers, update login credentials:
  • Login User
  • Login Password
  • Login Port
  • Home Directory path
4

Save Changes

Click “Save” to apply modifications.

​
Home Directory Configuration

The Home Directory field specifies where GamePanelX stores game server files on the remote server: 
/home/gameservers/  # Default location
Within this directory, GamePanelX creates:
  • /templates/ - Server templates
  • /servers/ - Active game servers
  • /logs/ - Installation and operation logs

​
Network Server Security

​
Credential Encryption

GamePanelX encrypts SSH credentials in the database using AES encryption: 
AES_ENCRYPT(login_user, 'encryption_key')
AES_ENCRYPT(login_pass, 'encryption_key')
AES_ENCRYPT(login_port, 'encryption_key')
The encryption key is stored in configuration.php. Protect this file with appropriate permissions (chmod 600) and never commit it to version control.

​
SSH Security Best Practices

Use SSH Keys

Prefer SSH key authentication over passwords when possible

Restrict SSH Access

Use firewall rules to limit SSH access to trusted IPs

Non-Standard Port

Consider using a non-standard SSH port to reduce automated attacks

Dedicated User

Create a dedicated user with minimal required permissions

​
Deleting Network Servers

To remove a network server:
  1. Edit the network server
  2. Scroll to the Delete option
  3. Click “Click Here” to confirm deletion
Before deleting a network server:
  • Remove or migrate all game servers on that network server
  • Delete all templates associated with that network server
  • Ensure no active processes are running
Deleting a network server with active game servers will cause those servers to become inaccessible.

​
Network Server Communication

GamePanelX communicates with remote servers using command wrappers:

​
Command Format

ssh -p [port] [user]@[ip] "GPX_Command -options"

​
Available Remote Commands

CommandPurpose
CreateTemplateCreate a new server template
DeleteTemplateRemove a template
CreateServerDeploy a new game server
DeleteServerRemove a game server
StartServerStart a game server
StopServerStop a game server
RestartServerRestart a game server
UpdateServerUpdate game server files
AutoInstallAutomatic game installation
SteamInstallLegacy Steam installer
SteamCMDInstallSteamCMD installer

​
Managing IP Addresses

For network servers with multiple IP addresses, you can configure additional IPs for game server assignments:
  1. Navigate to Network > Manage Server
  2. Click on the “IPs” tab
  3. Add additional IP addresses
  4. Assign IPs to specific game servers
Managing multiple IPs per network server allows better organization and resource allocation across your game server infrastructure.

​
Troubleshooting Network Servers

​
Cannot Connect to Remote Server

1

Verify SSH Access

Test SSH connection manually:
ssh -p [port] [user]@[ip]
2

Check Firewall Rules

Ensure the master server can reach the remote server:
  • SSH port (default 22) is open
  • No firewall blocking connection
3

Verify Credentials

Confirm username, password, and port are correct in the network server configuration.
4

Check Remote Scripts

Ensure GamePanelX remote server scripts are properly installed.

​
Commands Failing on Remote Server

  • Verify the SSH user has correct permissions
  • Check that screen is installed: which screen
  • Review remote server logs for errors
  • Ensure sufficient disk space: df -h

​
Callback Issues

If remote servers cannot callback to the master:
  • Verify the master server’s IP/hostname is accessible from remote servers
  • Check firewall rules allow incoming HTTP/HTTPS connections
  • Ensure Apache/Nginx is running on the master server
  • Review callback URL format in database
Callback URLs are automatically generated as:
http://[master-server]/includes/callback.php?token=[token]&id=[id]

​
Multi-Location Deployment

GamePanelX excels at managing game servers across multiple locations: Benefits:
  • Lower latency for players in different regions
  • Redundancy and high availability
  • Geographic distribution
  • Resource optimization

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us