SFTP
SFTP gives you a fast, resumable connection for big transfers — uploading a modpack, downloading a world, syncing with an external editor. For small edits, the editor in the Files tab is faster.
Prerequisites
Section titled “Prerequisites”- A server you can access, with
file.read— the SFTP tab appears with the same access as the Files tab, so a write-only subuser never sees it. - SFTP enabled on the node. If it is off, the tab says so.
- An SFTP client such as FileZilla, WinSCP, or Cyberduck.
Connect
Section titled “Connect”- Open the server’s SFTP tab. It shows Host, Port, Username and
Password, each with a copy button, plus a Quick Connect URI you can
paste into a client that understands
sftp://URLs. - In your client, choose protocol SFTP — Catalyst does not offer plain FTP — and paste the host, port, username and password exactly as shown.
- You land in your server’s root directory, the same files as the Files tab. Uploads, deletes, renames and permission changes show up there as they happen.
Two details:
- The username is the server’s ID, and the host and port belong to the node that runs the server.
- The password is a temporary token, not your panel password. The tab shows how long is left. Pick a Token lifetime and select Rotate password — or Generate new once it has expired — to issue a fresh one.
Every user gets their own credentials. If you are the owner, Active SFTP Sessions lists each user’s session with its expiry and a revoke button, plus Revoke all sessions. Removing a user from the server revokes their SFTP sessions immediately.
If the tab says “SFTP is disabled on this server.”, SFTP is turned off for the node — ask your administrator to enable it.
Good practice
Section titled “Good practice”- Stop the server before uploading or replacing world data or databases.
- If your client warns about an unknown host key on first connect, verify the fingerprint with your administrator before accepting it.
Troubleshooting
Section titled “Troubleshooting”- Authentication failed: credentials rotate — copy them fresh from the SFTP tab instead of reusing a saved password.
- Connection refused or timed out: the node may block the SFTP port, or your network may block outbound SSH. See networking issues.
- Transfers stall on huge folders: archive them first, upload one file, then extract it in the Files tab.