How to Use SFTP to Edit Game Server Files (FileZilla and WinSCP)
To reach your game server's files over SFTP, install FileZilla or WinSCP, set the protocol to SFTP (not plain FTP), and enter the Host, Port and Username from the blue SFTP bar at the top of your server's page in the panel. The password is your panel password. Once connected, you can drag mods and configs between your PC and the server.
The details that trip people up are the protocol setting, the port, and what happens when you edit files the server is still using. This guide covers each, plus the errors you are most likely to see. For a quick edit or a small upload you may not need SFTP at all: the Files tab in the panel is a browser file manager.
- Choose SFTP, not FTP or FTPS; plain FTP will not connect to your server.
- Copy Host, Port and Username from the blue SFTP bar in the panel. The password is your panel password.
- Stop the server before editing files that the game rewrites on shutdown; the Configs tab warns you which ones.
- Keep a copy of every file you change, and edit with a text editor that preserves line endings.
- Connection refused usually means a wrong protocol or port; authentication failed means the wrong username or panel password.
On this page
SFTP vs FTP: why the protocol setting matters
SFTP (SSH File Transfer Protocol) runs over SSH. Plain FTP is an older, unrelated protocol, and FTPS is FTP with TLS added. They are not interchangeable: an SFTP server will refuse an FTP client. The FileZilla documentation notes that SFTP servers typically use port 22 by default while normal FTP uses port 21. ChicagoServers shows its own SFTP port in the panel, so that number wins over any default. Plain FTP will not connect.
WinSCP's own troubleshooting page lists a protocol mismatch (SFTP selected against a server that only supports FTP, or the reverse) and an incorrectly entered non-standard port as common causes of a refused connection. If something fails immediately, check these two settings first.
What you need from your control panel
Open your server in the panel. Anyone with file access sees a blue SFTP bar near the top of the page with the three values you need, each with a copy button. You can also open the Files tab and click SFTP, which shows the same login plus the Folder. The ? on the bar opens step-by-step help for FileZilla and WinSCP.
- Host (an address or hostname)
- Port
- Username
- Password: your panel password. There is no two-factor prompt over SFTP, and a new panel password reaches SFTP within a minute.
Copy the values rather than retyping them, because a trailing space or a character that looks similar (0 and O, l and 1) is a classic cause of failed logins. The username may not match your account name, so use exactly what the panel shows. If you are a sub-user, you only see the SFTP bar when your permissions include Files, which also gives you SFTP.
How to connect with FileZilla
- Copy the details from the panel
On your server's page, copy Host, Port and Username from the blue SFTP bar. The password is your panel password.
- Use Quickconnect
In the Quickconnect bar, type
sftp://followed by the host, then the username, password and port, and click Quickconnect. Typingsftp://makes the protocol explicit, so you cannot end up on plain FTP. - Or save a site in the Site Manager
If you will reconnect often, use File, then Site Manager, and create a new site. In the Protocol dropdown choose the SFTP - SSH File Transfer Protocol entry, paste the host, enter the port from the panel, set Logon Type to Normal and enter the username and password. 'Ask for password' makes FileZilla prompt each session and remember it only for that session, which is safer on a shared PC.
- Accept the host key
On the first connection FileZilla shows an unknown host key dialog. If you typed the host yourself and it is correct, accept it and tick the box to trust it for future connections. A later warning that the key has changed means the server's identity differs from before; do not continue until you know why.
- Open your server's folder
After connecting, open the server's folder in the home folder. The panel's Files tab shows the same folder name under SFTP.
How to connect with WinSCP
- Open the Login dialog
WinSCP shows it at startup. Create a new site. The panel's SFTP help also offers Open in WinSCP (and Cyberduck) as a shortcut.
- Set the file protocol to SFTP
Pick SFTP from the File protocol dropdown. FTP and SCP are separate choices.
- Enter the host name and port
Paste the host. WinSCP's documentation says the port is usually left blank so the default is used (22 for SSH), but enter the port from your panel, because that is the one your server uses.
- Enter the user name and password
Use the username from the SFTP bar and your panel password. WinSCP advises against saving passwords with the site. If you do not store it, WinSCP prompts at login.
- Save and log in
Press Save to keep the site, then Login. Accept the host key prompt the first time if the host is the one you typed, then open the server's folder in the home folder.
Uploading mods and config files
Which folder holds mods or configs depends entirely on the game: a Minecraft mods or plugins folder, a Rust oxide or carbon folder, a Valheim BepInEx plugins folder and so on. Your game's documentation or your mod's install instructions will say where files belong. If a folder you expect is missing, the server may need to start once so the game creates it. Several games also have a Mods or Plugins tab in the panel that installs and removes mods for you, so check there first.
- Upload mods in the form the mod author provides (a .jar, .dll or folder). Do not unzip an archive unless the instructions say to.
- Match versions: a mod built for a different game version is the most common reason a server will not start after an upload.
- Upload one change at a time, restart, and check the Console tab for errors before adding the next. Valheim, Vein, Enshrouded, Satisfactory and Windrose have no server console, so they show output only.
- Large uploads are easier as a single
.zip. In the Files tab, right-click the .zip (or tap the three dots) and choose Extract here, then delete the .zip. SFTP is the better route for big uploads. While an install or update is running, the server's folder is read-only over SFTP, so wait for it to finish.
WinSCP's transfer mode defaults to Automatic, which picks text or binary per file by extension. Binary files like mods must never be transferred in text mode. If you are unsure, set transfer mode to Binary for mods and archives.
Editing config files safely
- Download a copy first. Keep the original with a date in its name. For anything risky, make a World and settings backup on the Backups tab as well.
- Stop the server before editing if the game writes configs back on shutdown. Some games read the file at startup and write their in-memory settings back when they stop, so edits made while running can be lost. The Configs tab shows Stop the server before editing this file for those files, and the same rule applies on the Files tab and over SFTP. ARK's two .ini files are the exception on the Configs tab: changes saved while it runs are put back after a panel stop or restart.
- Use a real text editor such as VS Code or Notepad++. Many game servers run on Linux and expect Unix line endings (LF), and a stray byte order mark can break parsers in some games. Keep files in UTF-8 unless the game says otherwise.
- Change one thing at a time and keep the file's exact format: quotes, indentation and commas in JSON, XML and INI files all matter.
- Start the server and read the console to confirm the setting loaded. Click Restart at the top of the page; changes apply when the game next starts.
Many games' main config files are on the Configs tab already: pick the file, edit it in the Settings view or switch to Text for the whole file, click Save, then Restart. Any text file can also be edited on the Files tab by clicking it, then Save (or Ctrl+S). Settings the panel controls (the server name, passwords, ports and player slots) are written from the Startup tab and your plan at every start, so editing them in a file does not stick. Change them on the Startup tab instead.
Over SFTP, in FileZilla, using View/Edit opens a temporary local copy and offers to upload when you save. In WinSCP, opening a remote file in an editor works similarly, and WinSCP has a built-in editor that avoids the download-edit-upload cycle altogether. WinSCP can convert line endings in text mode for older protocol versions; its documentation suggests keeping the Unix server format as the default, which suits most servers.
Common SFTP errors and fixes
| Error | Likely cause | Fix |
|---|---|---|
| Connection refused | Wrong protocol or wrong port (plain FTP will not connect to your server) | Confirm SFTP is selected, and re-enter the Host and Port from the blue SFTP bar |
| Connection timed out | Wrong host, a firewall, or a network that blocks outbound non-standard ports | Recheck the host, try another network or hotspot, and temporarily disable VPN |
| Authentication failed / access denied | Wrong username or password, or stray whitespace | Copy the username from the SFTP bar again and use your panel password, not a game or RCON password. If you just changed the panel password, wait a minute for it to reach SFTP |
| Host key has changed | The server's identity differs from the stored one | Confirm with support before accepting; do not click through blindly |
| Permission denied / read-only | You are writing outside your server's folder, or an install or update is running (the folder is read-only over SFTP meanwhile) | Work inside the server's folder, wait for the install or update to finish, and ask support if a file you must edit is locked |
| No SFTP bar, or login refused for a sub-user | The sub-user does not have the Files permission, which is what gives SFTP | Ask the owner to tick Files for you under Sub-users |
| Files uploaded but changes do not apply | Server was running and overwrote the file, you edited the wrong copy, or the value is controlled from the Startup tab | Stop the server, edit, then start it; change the name, passwords, ports and slots on the Startup tab instead |
Frequently asked questions
What port does SFTP use for a game server?
SFTP's standard port is 22, but your server may use a different one. Use the exact Port shown on the blue SFTP bar in your panel.
Should I choose FTP or SFTP in FileZilla?
Choose SFTP. Plain FTP will not connect to a ChicagoServers server, and selecting the wrong protocol gives refused or failed connections. Typing sftp:// before the host in the Quickconnect bar avoids the mistake.
Why do my config changes disappear after a restart?
Some games rewrite their config files from memory when they shut down, overwriting edits made while running, so stop the server fully, edit the file, then start it. Also, the server name, passwords, ports and player slots are written from the Startup tab at every start, so change those there.
Is FileZilla or WinSCP better for a game server?
Both work. FileZilla runs on Windows, macOS and Linux, while WinSCP is Windows-only and has a built-in editor and scripting. Pick the one you find easier.