SFTPGo

SFTPGo is a modern, open-source SFTP server with multi-user management, a web interface and S3-compatible storage backends like Cellar.

Overview

Clever Cloud provides built-in SFTP access to FS Buckets, but if you need advanced user management, fine-grained access control, or want to expose files stored in Cellar over SFTP, you can deploy SFTPGo as a Docker application.

Requirements

You need git and a Clever Cloud account.

Create and configure resources on Clever Cloud

1. Create a Docker application (XS size or above) from the Console
2. Create a PostgreSQL add-on (version 15, XXS Small Space) and link it to your application
3. Create a Cellar add-on for S3-compatible object storage and link it to your application
4. Enable TCP redirection on your Docker application from the Console

Prepare the project

Initialize a Git repository with a minimal Dockerfile:

mkdir my-sftpgo && cd my-sftpgo
git init

Create a Dockerfile at the root of the project

FROM drakkan/sftpgo:latest

Set environment variables

Add the following environment variables to your Docker application in the console. Replace placeholder values with the credentials provided by Clever Cloud for your PostgreSQL add-on:

CC_DOCKER_EXPOSED_TCP_PORT="2022"
SFTPGO_DATA_PROVIDER__DRIVER="postgresql"
SFTPGO_DATA_PROVIDER__HOST="<pg_host>"
SFTPGO_DATA_PROVIDER__NAME="<pg_dbname>"
SFTPGO_DATA_PROVIDER__PASSWORD="<pg_password>"
SFTPGO_DATA_PROVIDER__PORT="<pg_port>"
SFTPGO_DATA_PROVIDER__USERNAME="<pg_user>"

Deploy

First, commit and push your code:

git add .
git commit -m "Deploy SFTPGo"
clever link <your-app-id>
clever deploy

Or using a Git remote:

git remote add clever <your-clever-git-url>
git push clever master

Initialize SFTPGo

1. Open your application URL in a browser
2. Follow the setup wizard to create an admin account

Connect Cellar as a storage backend

In the SFTPGo web admin interface, create a new user with an S3-compatible filesystem:

Connect with an SFTP client

Use any SFTP client (such as FileZilla, Cyberduck, or the sftp CLI) with:

• Host: shown in the TCP redirection tab of your application in the console
• Port: shown in the TCP redirection tab
• Username & Password: your SFTPGo admin credentials

🎓 Learn more