SFTP Connection

Connect to your Cafora Minecraft server files via SFTP through the TCPShield-protected entry point.

SFTP (SSH File Transfer Protocol) lets you connect directly to your server's file system using a desktop client. It is faster and more convenient than the web File Manager for bulk uploads, large files, and advanced workflows.

Cafora routes SFTP through TCPShield Sentry, the same protected entry point used for Minecraft. This means file transfers are shielded from DDoS attacks and the origin IP is never exposed.

Getting Your SFTP Credentials

SFTP credentials are unique to each server and can be found in the Pterodactyl Panel:

Open the Pterodactyl Panel
Select your server
Click the Settings tab
Look for SFTP Details — you will see:

Field	Description
Address	`sftp.caforahost.com`
Port	`2022`
Username	A unique username for your server (e.g., `username.serverid`)
Password	Your Pterodactyl Panel password

SFTP uses a dedicated hostname (sftp.caforahost.com) instead of the node's FQDN. The node FQDN is reserved for Wings API traffic over Cloudflare Tunnel. See DDoS Protection.

If you change your panel password, your SFTP password updates automatically. Keep your credentials secure.

Connecting with FileZilla

FileZilla is the most popular free SFTP client.

Download and install FileZilla
Open FileZilla and fill in the Quickconnect bar:
- Host: sftp://sftp.caforahost.com
- Username: Your SFTP username
- Password: Your panel password
- Port: 2022
Click Quickconnect
Accept the host key if prompted

Connecting with WinSCP

WinSCP is a popular Windows SFTP client.

Download and install WinSCP
Open WinSCP and create a new session:
- File protocol: SFTP
- Host name: sftp.caforahost.com
- Port number: 2022
- User name: Your SFTP username
- Password: Your panel password
Click Login
Accept the host key if prompted

Connecting via Command Line

If you have an SSH/SFTP client installed (OpenSSH comes with Windows 10+, macOS, and Linux):

sftp -P 2022 username.serverid@sftp.caforahost.com

Once connected, common commands:

Command	Description
`ls`	List files
`cd <directory>`	Change directory
`get <file>`	Download a file
`put <file>`	Upload a file
`put -r <folder>`	Upload a folder recursively
`rm <file>`	Delete a file
`exit`	Disconnect

Tip: Use put -r to upload entire plugin or world folders in one command.

Connecting with VS Code

If you use VS Code, the SFTP extension gives you an integrated file browser:

Install the SFTP extension by Natizyskunk
Press Ctrl+Shift+P and run SFTP: Config
Fill in the configuration:

{
  "name": "My Cafora Server",
  "host": "sftp.caforahost.com",
  "protocol": "sftp",
  "port": 2022,
  "username": "username.serverid",
  "password": "your-password",
  "remotePath": "/",
  "uploadOnSave": false
}

Save the config, then right-click the server in the SFTP sidebar and choose Connect

Key Directories

Once connected, you will see the same file structure as the File Manager:

Directory	Purpose
`/` (root)	Server jar, eula.txt, server.properties
`/plugins/`	Plugin `.jar` files and data
`/mods/`	Mod `.jar` files
`/config/`	Mod and plugin configuration
`/world/`	Main world data
`/world_nether/`	Nether dimension
`/world_the_end/`	End dimension
`/logs/`	Server log files

When to Use SFTP vs File Manager

Task	Recommended Tool
Uploading a single plugin	File Manager
Editing a config file	File Manager
Uploading a large modpack	SFTP
Bulk file operations	SFTP
Downloading world backups	SFTP
Quick inspection	File Manager

Troubleshooting

Connection Refused or Timed Out

Verify the server is online — SFTP is unavailable when the server is stopped
Check that you are connecting to sftp.caforahost.com on port 2022
Ensure your firewall is not blocking outbound port 2022

Authentication Failed

Verify the username exactly as shown in the panel (it is case-sensitive)
Try resetting your panel password from store.caforahost.com

Connection Dropping During Large Transfers

Some clients have idle timeouts — enable keep-alive in your client settings
Split large transfers into smaller batches