Upload Your Bot Files via SFTP

Uploading your code via SFTP offers several advantages, including the ability to upload folders or files larger than 100 MB.

DDoS Protection

If SFTP is not working, it may be because the node hosting your server is under a denial-of-service (DDoS) attack and protection is active. In this case, please wait a few moments. In the meantime, you can always use Web FTP.

Prerequisites

To upload via SFTP, you must first have an SFTP client installed on your computer. We recommend FileZilla.

Retrieve Your SFTP Credentials

1. Log in to control.katabump.com
2. Select your server
3. Go to the "Settings" section
4. Note the following information:

Information	Value
Server Address	sftp://sftp.xx-node-xx.katabump.com:2022 (unique per server)
Username	Your server ID (e.g. 16a1bf28f279784.8te7827)
Password	Same password used to access your control.katabump.com account (found on dashboard.katabump.com)

Security

Never share your SFTP credentials. They give full access to your files.

Configure FileZilla

FileZilla is the most popular SFTP client — free and cross-platform.

1. Download FileZilla

• Download FileZilla Client
• Install the software on your computer

2. Set Up the Connection

1. Open FileZilla
2. In the quick connect bar at the top, enter:
   • Host: Your full server address (e.g. sftp://sftp.xx-node-xx.katabump.com:2022)
   • Username: Your server ID
   • Password: Your control panel password
   • Port: Leave blank (the port is included in the server address)
3. Click "Quickconnect"

First Connection

If this is your first time connecting, a pop-up window will appear asking you to trust the host key. Click OK to continue.

Unsecured Network

If this is your first time logging in and you are currently on an unsecured network, please wait until you are on a secure network to continue.

Transfer Your Files

FileZilla Interface

FileZilla is divided into two panels:

• Left: Your local files (your computer)
• Right: Your KataBump server

Upload Files

1. In the left panel, navigate to your project
2. In the right panel, open the /home/container folder
3. Select the files to upload (Ctrl+click for multiple)
4. Drag and drop into the right panel

Best Practice

Always upload to /home/container, never to the root. This is your application's root directory.

Download Files

1. Select the files in the right panel (server)
2. Drag them to the left panel (local)
3. Or right-click → "Download"

Other SFTP Clients

WinSCP (Windows)

1. Download WinSCP
2. Protocol: SFTP
3. Host: Your server address
4. Fill in credentials as above

Cyberduck (macOS/Windows)

1. Download Cyberduck
2. Server: Your SFTP server address
3. Enter your credentials

VSCode with SFTP Extension

Install the "SFTP" extension by liximomo:

// .vscode/sftp.json
{
  "name": "KataBump",
  "host": "sftp.xx-node-xx.katabump.com",
  "protocol": "sftp",
  "port": 2022,
  "username": "your-server-id",
  "password": "your-control-panel-password",
  "remotePath": "/home/container",
  "uploadOnSave": true
}

Command Line (OpenSSH)

# Connect via SFTP
sftp -P 2022 your-server-id@sftp.xx-node-xx.katabump.com

# Commands once connected
ls          # List files
cd          # Change directory
put file    # Upload a file
get file    # Download a file
rm file     # Delete a file
exit        # Quit

Server File Structure

/home/container          ← Application root
├── package.json         ← Node.js
├── requirements.txt     ← Python
├── node_modules/        ← Node.js dependencies
└── .venv/               ← Python virtual environment

Entry Point

KataBump runs the file you configured in the "Startup" section (JS FILE or PY FILE) from /home/container.

Next Step

Once your files are uploaded, configure your environment variables to secure your tokens.