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 key only (no passwords) |
Getting connected
- Your CarBuddy account manager provisions your SFTP account and sends you:
- host
sftp.carbuddy.uk - port
30022 - username
- an SSH private key file (
.pem), or confirmation that your own public key has been registered
- host
- Save the private key securely. In most setups it is only shown once.
- Test the connection:
sftp -P 30022 -i /path/to/your-key.pem your-username@sftp.carbuddy.uk
If your IT policy requires using your own SSH key pair, send the public key to your CarBuddy account manager before go-live.
Supported key types: RSA (2048-bit minimum) and ED25519 where supported by your SFTP client.
Upload path and folder setup
CarBuddy creates your SFTP account and upload directory in advance. Upload every batch into the same /uploads/ folder — you do not need to create a new folder for each EVHC/RTC delivery or ask us to provision it again each time.
File format
Drop files as CSV into /uploads/. Use a descriptive filename ending in .csv, for example evhc-2026-04-15.csv or rtc-2026-04-15.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) | Check you're using the correct private key, or contact your account manager to reissue/register the key |
| 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.