SFTP Integration
The SFTP gateway is the recommended method for recurring data delivery. Your DMS or data team drops files to a dedicated SFTP endpoint and CarBuddy picks them up automatically.
Connection details
| Setting | Value |
|---|---|
| Host | sftp.carbuddy.uk |
| Port | 30022 |
| Username | Provided by your account manager |
| Authentication | SSH public key only (no passwords) |
Key setup
- Generate an SSH key pair on your server:
ssh-keygen -t ed25519 -C "your-dealership-sftp" -f ~/.ssh/carbuddy_sftp - Send the public key (
~/.ssh/carbuddy_sftp.pub) to your CarBuddy account manager - Your account manager registers the key and confirms your username
- Test the connection:
sftp -P 30022 -i ~/.ssh/carbuddy_sftp your-username@sftp.carbuddy.uk
Supported key types: ED25519 (recommended), RSA (2048-bit minimum)
File format
Drop files as CSV to your SFTP home directory. The filename should follow the pattern YYYY-MM-DD-upload.csv or any descriptive name ending in .csv.
See the CSV upload guide for required columns and format spec.
Processing
Files are picked up within 5 minutes of upload. You'll see the batch appear in the portal under Upload History. An email confirmation is sent once processing completes.
Troubleshooting
| Problem | Solution |
|---|---|
Permission denied (publickey) | Key not yet registered — contact your account manager |
| Connection refused on port 30022 | Check your firewall allows outbound connections to sftp.carbuddy.uk:30022 |
| File uploaded but not appearing in portal | Check the file is a valid CSV; contact support if the problem persists |
For help, open a ticket in the portal support system.