1 What SFTP is and why you want it
SFTP (SSH File Transfer Protocol) is a secure way to move files between your computer and your game server. The Solace web panel has a built-in file manager that's fine for quick edits, but anything heavier — uploading a mod pack, editing dozens of config files, pulling a backup — is a lot faster over SFTP.
Common reasons to use it:
- Upload large mod packs or world files without waiting on browser uploads.
- Edit config files in a real text editor (VS Code, Notepad++, Sublime).
- Download backups, world saves, or logs to your computer.
- Bulk-replace plugin folders during a wipe or migration.
2 Find your SFTP credentials
Log into the Solace panel and open your server. In the sidebar, click Settings (or the gear icon) and look for the SFTP Details block. You'll see:
- Host — usually something like
node-va1.solaceservers.comor your server's IP. - Port — typically
2022(not 22). - Username — looks like
username.serverid. - Password — the same password you use to log into the Solace panel. If you reset your panel password, your SFTP password updates with it.
3 Pick a client
Any modern SFTP client works. Two we recommend:
FileZilla Windows · Mac · Linux
Free, lightweight, drag-and-drop interface. Best if you've never used SFTP before.
Download FileZilla →WinSCP Windows
Free, integrates with Windows Explorer, can edit files in your default editor.
Download WinSCP →If you're on Mac and don't want FileZilla, Cyberduck is also a clean option. Power users can use the sftp command from any terminal.
4 Connect with FileZilla
- Open FileZilla and click File → Site Manager (or press
Ctrl+S). - Click New Site and give it a name like "Solace - My Server."
- Fill in:
- Protocol:
SFTP - SSH File Transfer Protocol - Host: your Solace SFTP host
- Port:
2022 - Logon Type:
Normal - User: your
username.serverid - Password: your panel password
- Protocol:
- Click Connect. The first time you connect, FileZilla will ask you to trust the host key — click OK and check the box to remember it.
Your server's file tree appears on the right. Drag files between your local computer (left pane) and the server (right pane) to upload or download.
5 Connect with WinSCP
- Open WinSCP. The Login window appears.
- Set File protocol to
SFTP. - Enter Host name, Port number
2022, User name, and Password. - Click Save if you want to keep the session, then Login.
- Accept the host key fingerprint on first connect.
WinSCP gives you a two-pane file manager. Tip: right-click any file and choose Edit to open it in your default text editor — saves automatically push back to the server.
6 Common mistakes & fixes
"Connection refused" or "Could not connect to server"
- You probably typed port
22. Solace SFTP uses port2022. - Double-check the host — copy/paste from the panel, don't type it from memory.
"Authentication failed"
- Username must include the
.serveridsuffix exactly as shown in the panel. - If you recently changed your panel password, that's now your SFTP password too.
"Permission denied" when uploading
- Stop the server before doing major file operations — some files are locked while the server is running. World saves and config files can usually be edited live; binaries and large mod folders are safer with the server stopped.
world/ or your save) can wipe your server. Always download a backup first if you're about to do something risky. The Solace panel has one-click backups under the Backups tab.