
Changing the Server Storage Location
By default, GameCP stores all game server files in a ./servers directory relative to the node agent. If you need to use a different disk, partition, or custom path, you can change this in the node's advanced configuration.
Important: No Existing Game Servers
You should only change the storage location on a node that has no game servers currently installed. Changing the path on a node with existing servers will cause those servers to become inaccessible since the node will look for files in the new location.
Warning: Remove or migrate any existing game servers before changing the storage path.
Step 1: Open the Node Settings
From your GameCP dashboard, navigate to the Nodes page using the sidebar. Click on the node you want to configure to open its settings.
Step 2: Enable Advanced Configuration
Scroll down to the Advanced Configuration section. Toggle the Enable Advanced Configuration switch to reveal the advanced settings.
Step 3: Set the Servers Folder
Under the Game Configuration heading, you'll see two path fields:
- Game Path β where game templates are stored (default:
./games) - Servers Folder β where game server instances are stored (default:
./servers)
Change the Servers Folder field to your desired path. For example:
/mnt/storage/serversβ a mounted secondary drive/home/gamecp/serversβ a custom home directory/data/game-serversβ a dedicated data partition
Tip: Make sure the path exists on the server and the user running the GameCP agent has read/write permissions to it.
Step 4: Save the Changes
Click Save at the top of the node settings to persist your changes.
Step 5: Restart the Node Application
The new path won't take effect until the node agent restarts. To apply the changes:
- Open the node's Action Menu (the three-dot menu or action button)
- Click Restart App
- Wait for the node to come back online
The node agent will now use the new directory for all future game server installations.
Verifying the Change
After restarting, any new game server you create on this node will have its files stored in the new location. You can verify by SSHing into your server and checking the directory:
ls -la /mnt/storage/servers
Troubleshooting
Node goes offline after restart
- Verify the path exists:
mkdir -p /your/new/path - Check permissions:
chown -R $(whoami) /your/new/path
Existing servers show as broken If you changed the path on a node that had existing servers, either:
- Change the path back to the original location and restart again
- Manually move the server files to the new location
Path not applying Make sure you saved the node settings before restarting. The restart only picks up the last saved configuration.