Public | Automated Build

Last pushed: a year ago
Short Description
SFTP server (forked from atmoz/sftp) based on Alpine
Full Description

Easy to use SFTP (SSH File Transfer Protocol) server with OpenSSH. This is an automated build linked with the alpine repository.

Why fork atmoz/sftp ?

Why use bigger image for a simple SFTP server ?
Personnaly, I think alpine was a better choice for this use.
It take only 6 MB of memory and 6 KB (12.5 MB virtual) on disk instead of 18 MB / 1.6 MB (145 MB virtual) for debian (on my laptop).

I just adapt atmoz configuration for alpine image.
The usage is really the same (his unit test ran on it).


  • Define users as command arguments, STDIN or mounted in /etc/sftp-users.conf
    (syntax: user:pass[:e][:uid[:gid]]...).
    • You must set custom UID for your users if you want them to make changes to
      your mounted volumes with permissions matching your host filesystem.
  • Mount volumes in user's home folder.
    • The users are chrooted to their home directory, so you must mount the
      volumes in separate directories inside the user's home directory


Simple docker run example

docker run \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d atmoz/sftp \

Using Docker Compose:

    image: atmoz/sftp
        - /host/share:/home/foo/share
        - "2222:22"
    command: foo:123:1001

Logging in

The OpenSSH server runs by default on port 22, and in this example, we are
forwarding the container's port 22 to the host's port 2222. To log in with the
OpenSSH client, run: sftp -P 2222 foo@<host-ip>

Store users in config

docker run \
    -v /host/users.conf:/etc/sftp-users.conf:ro \
    -v /host/share:/home/foo/share \
    -v /host/documents:/home/foo/documents \
    -v /host/http:/home/bar/http \
    -p 2222:22 -d atmoz/sftp



Encrypted password

Add :e behind password to mark it as encrypted. Use single quotes if using terminal.

docker run \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d atmoz/sftp \

Tip: you can use makepasswd to generate encrypted passwords:
echo -n "password" | makepasswd --crypt-md5 --clearfrom -

Using SSH key (without password)

Mount all public keys in the user's .ssh/keys/ folder. All keys are automatically
appended to .ssh/authorized_keys.

docker run \
    -v /host/ \
    -v /host/ \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d atmoz/sftp \

Execute custom scripts or applications

Put your programs in /etc/sftp.d/ and it will automatically run when the container starts.
See next section for an example.

Bindmount dirs from another location

If you are using --volumes-from or just want to make a custom directory
available in user's home directory, you can add a script to /etc/sftp.d/ that
bindmounts after container starts.

# Just an example (make your own):
function bindmount() {
    if [ -d "$1" ]; then
        mkdir -p "$2"
    mount --bind $3 "$1" "$2"

# Remember permissions, you may have to fix it:
# chown -R :users /data/common

bindmount /data/admin-tools /home/admin/tools
bindmount /data/common /home/dave/common
bindmount /data/common /home/peter/common
bindmount /data/docs /home/peter/docs --read-only
Docker Pull Command
Source Repository