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.com or 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.
Tip: Solace doesn't store your password as plain text. Treat your SFTP credentials like any other login — don't share them with people you wouldn't give panel access to.

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

  1. Open FileZilla and click File → Site Manager (or press Ctrl+S).
  2. Click New Site and give it a name like "Solace - My Server."
  3. 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
  4. 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

  1. Open WinSCP. The Login window appears.
  2. Set File protocol to SFTP.
  3. Enter Host name, Port number 2022, User name, and Password.
  4. Click Save if you want to keep the session, then Login.
  5. 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 port 2022.
  • Double-check the host — copy/paste from the panel, don't type it from memory.

"Authentication failed"

  • Username must include the .serverid suffix 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.
Heads up: SFTP gives you direct file access. Deleting or overwriting the wrong folder (especially 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.

New to Solace?

Spin up a server in under a minute and try this on a real environment.

Browse Game Servers →