SFTP Access to the Game Server – Manage Files

SFTP is the practical way to manage your game server files outside the panel: edit configurations, upload plugins or mods, save logs, and download worlds. All you need is a suitable client, the credentials from the dashboard, and some care when overwriting important files.

What SFTP Does for a Game Server

SFTP stands for SSH File Transfer Protocol and transfers files over an encrypted connection. For game servers, this is especially useful because you do not have to make every change through a browser file manager. Large folders, many plugin files, or local backups are usually easier to manage with a desktop client.

The distinction is important: SFTP is not the same as classic FTP. If your client offers several protocols, explicitly select SFTP. FileZilla lists SFTP as a supported protocol in its official documentation; WinSCP officially describes itself as a client for file transfers, including via SFTP. Therefore, use the official downloads and avoid unofficial installers from third-party sites.

Requirements

You need an active game server, access to your game-serverhosting dashboard, and an SFTP client on your computer. You should also create a backup before risky changes or at least download the affected files locally. This is especially true for worlds, databases, server configurations, and plugin folders.

If you are currently coming from another provider, the guide Moving a game server: From any hosting provider to game-serverhosting helps you with the order of backup, upload, and verification. For Minecraft-specific extensions, the guide Install & manage Minecraft plugins – Spigot/Paper in the panel adds plugin details to the SFTP steps.

Install an SFTP Client

For Windows, WinSCP is often convenient because interface, editor integration, and synchronization are clearly separated. FileZilla is cross-platform and works well if you want to work similarly on Windows, macOS, or Linux. Cyberduck is also an option if you prefer a simple interface.

Establish the Connection

Open your SFTP client and create a new connection. You can find the values in your server dashboard. Do not send them to third parties via screenshot, and only save passwords on devices you trust.

Then click Connect. During the first connection attempt, your client may ask for a host key. Check whether you are connecting to the correct host and confirm the key only if the server details are correct. After that, the client usually shows two areas: your local files on the left and the files on the game server on the right.

Typical Folder Structure

The exact structure depends on the game and the server type used. However, many setups are based on a container directory like this:

/home/container/
├── server.properties     # Server config
├── plugins/              # Plugins (Paper/Spigot)
├── mods/                 # Mods (Forge/Fabric)
├── world/                # Game world
├── logs/                 # Server logs
└── backups/              # Backups

Edit files as specifically as possible. First download a configuration file, edit it locally in a suitable editor, and then upload it again. Make sure not to change file extensions. For example, server.properties must not accidentally become server.properties.txt.

Common Tasks

• Edit config: Download file → edit → upload
• Install plugins: Upload JAR to /plugins/
• Download backups: Download /world/ folder
• Check logs: Download latest.log

For plugins or mods, you should check server version, loader, and dependencies before uploading files. A Paper plugin usually belongs in /plugins/, while a Forge or Fabric mod belongs in /mods/. After the upload, a restart is usually required so the server loads the new file.

For world backups, a clear process is recommended: stop the server, download the world folder, give the local copy a meaningful name, and only then make larger changes. If the server is actively writing while copying, a backup can become incomplete or inconsistent.

Check the Result

After a change, first check whether the upload completed fully. Many SFTP clients show failed transfers in a queue or error tab. Then restart the game server if needed and check the logs. For Minecraft, latest.log is often the first place to look; other games have their own log files in the respective server directory.

Then test in the game or panel whether the change is actually active. An uploaded file alone does not mean that it was read by the server. What matters is whether startup completes without errors and the desired function is visible.

Tips for Clean Work

• Drag & drop: Transfer files easily via drag & drop
• Double-click: Open files directly in the editor
• Synchronize: Some clients offer folder synchronization
• Key auth: SSH keys instead of a password for more security

Still work in a controlled way: synchronization can quickly transfer local mistakes to the server. If you replace many files, check the target folder and synchronization direction beforehand. For configuration files, a local copy before every change makes sense.

Troubleshooting

If the connection fails, first check protocol, host, port, username, and password. A common mistake is accidentally selecting FTP instead of SFTP or entering the wrong port. The default port used in many Pterodactyl setups is 2022; however, the values from your dashboard are always authoritative.

If the upload breaks off, the local connection may be unstable or the target folder may be missing. Repeat the transfer and watch whether your client uploaded only part of a file. If in doubt, delete the incomplete target file and upload it again.

If the server does not start after a change, upload the last working file again or remove the most recently uploaded plugin or mod. Then check the logs. For basic terminal work around server files, the guide Linux game server commands – The most important terminal commands will also help you.

Verification, Limits, and Safe Rollback

The guide “SFTP Access to the Game Server – Manage Files” applies to the server type described in the article and the version state visible at the time of verification. Menu names, available versions, mod or plugin compatibility, and required resources may differ after updates. Therefore, do not transfer any values to another game, loader, or server version without checking them first.

Before making changes to the world, savegame, configuration, or extensions, create a backup of the affected files. Then change only one related step and verify it with the same client and server version that you want to play with later.

A successful individual test is not a performance or availability guarantee. World size, mods, plugins, player count, network path, and simultaneous load can change the result. Document the version, change, and test result so you can understand later deviations.

FAQ

Is SFTP More Secure Than FTP?

Yes, SFTP transfers files over an encrypted connection. Still, it is important that you protect credentials, use only trusted clients, and do not store saved passwords on shared devices.

Which SFTP Client Should I Use?

Use the client you can work with reliably. FileZilla is cross-platform, WinSCP is very popular on Windows, and Cyberduck works on macOS and Windows. Download the client directly from the official website.

Do I Have to Stop the Game Server Before Every Upload?

Not for every file. For logs or simple downloads, this is usually not necessary. For world folders, databases, mods, plugins, or central configurations, stopping or restarting makes sense depending on the change so that files are not written at the same time.

Why Don’t I See My Uploaded Change in the Game?

Possible reasons include a missing restart, the wrong target folder, an incompatible plugin or mod version, or an error in the configuration. First check the upload, then the server logs, and then the exact path.

Can I Download Complete Backups via SFTP?

Yes, you can download folders such as /world/ or existing backup directories. For consistent game world backups, you should stop the server beforehand or use your panel’s backup function if it is available for your server.