Sync & mount

Access PutFS data via WebDAV, S3, or direct filesystem mount.

WebDAV (nginx)

Nginx handles WebDAV natively. Enables access from rclone, macOS Finder, Cyberduck:

location /dav/ {
    alias /srv/putfs/;
    dav_methods         PUT DELETE MKCOL COPY MOVE;
    dav_ext_methods     PROPFIND OPTIONS;
    dav_access          user:rw group:r all:r;
    create_full_put_path on;
    client_max_body_size 0;
}

Requires nginx-full (Debian/Ubuntu) or ngx_http_dav_ext_module.

S3 API

Minimal S3 subset – works with aws s3, rclone, boto3:

aws s3 cp file.txt s3://my-dataset/key --endpoint-url http://localhost:8000
rclone ls :s3,provider=Other,endpoint=http://localhost:8000: my-dataset/

SFTP / SCP

It's a plain filesystem – expose via OpenSSH:

# /etc/ssh/sshd_config
Match Group putfs-users
    ChrootDirectory /srv/putfs
    ForceCommand internal-sftp

Further reading

• nginx WebDAV module
• nginx dav_ext_module
• rclone S3
• rclone WebDAV