crazy-max/docker-pure-ftpd
crazy-max/docker-pure-ftpd has 65 GitHub stars and 19 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-22 20:59 UTC. Last push 2026-11-14.
What you can do
- Multi-platform image
- s6-overlay as process supervisor
- PureDB, MySQL, PostgreSQL and LDAP support
- Pure-FTPd compiled from source
Progression mesurée des étoiles
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Historique en cours
- in 1 month
- Historique en cours
Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.
À propos
Pure-FTPd Docker image with PureDB, MySQL, PostgreSQL and LDAP authentication support
DonnéesREADME.md
OriginalAbout
Pure-FTPd Docker image based on Alpine Linux, with PureDB, MySQL, PostgreSQL and LDAP authentication support.
[!TIP] Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!
- Features
- Build locally
- Image
- Environment variables
- Volumes
- Ports
- Usage
- Upgrade
- Notes
- Contributing
- License
Features
- Multi-platform image
- s6-overlay as process supervisor
- PureDB, MySQL, PostgreSQL and LDAP support
- Pure-FTPd compiled from source
- Argon2 and scrypt password hashing through libsodium
- Logs sent to
stdoutthrough socklog-overlay - Run a script after each upload with
pure-uploadscript - Automatic public IP detection for passive connections
Build locally
git clone https://github.com/crazy-max/docker-pure-ftpd.git
cd docker-pure-ftpd
# Build image and output to docker (default)
docker buildx bake
# Build multi-platform image
docker buildx bake image-all
Image
| Registry | Image |
|---|---|
| Docker Hub | crazymax/pure-ftpd |
| GitHub Container Registry | ghcr.io/crazy-max/pure-ftpd |
The image supports the following platforms:
$ docker buildx imagetools inspect crazymax/pure-ftpd --format "{{json .Manifest}}" | \
jq -r '.manifests[] | select(.platform.os != null and .platform.os != "unknown") | .platform | "\(.os)/\(.architecture)\(if .variant then "/" + .variant else "" end)"'
linux/amd64
linux/arm/v6
linux/arm/v7
linux/arm64
linux/ppc64le
Environment variables
TZ: Timezone assigned to the container (defaultUTC)AUTH_METHOD: Authentication method:puredb,mysql,pgsqlorldap(defaultpuredb)SECURE_MODE: Enable secure mode (defaulttrue)PASSIVE_IP: IP address or hostname advertised for passive connections. Defaults to the public IP returned bydig +short myip.opendns.com @resolver1.opendns.com.PASSIVE_PORT_RANGE: Port range for passive connections (default30000:30009)DB_TIMEOUT: Database startup timeout in seconds, used only withmysqlandpgsqlauthentication (default45)UPLOADSCRIPT: Absolute path to a program or script to run after an upload (for example/data/uploadscript.sh)
[!IMPORTANT] Set
UPLOADSCRIPTto the absolute path of a program or script inside the container. The image adds--uploadscriptautomatically; do not add it to/data/pureftpd.flagsyourself.
Volumes
/data: Configuration files, TLS certificates and the PureDB user database
[!IMPORTANT] Mount FTP users' home directories separately to persist uploaded files. Mounting
/dataalone does not persist files stored under/home.
Ports
2100: FTP port30000-30009: PASV port range
[!NOTE] If you change
PASSIVE_PORT_RANGE, publish the same range on the host and allow it through your firewall. SetPASSIVE_IPto an address or hostname reachable by your clients if automatic public IP detection does not suit your network.
Usage
Docker Compose
Docker Compose is the recommended way to run this image. Save the
Compose template as compose.yml, then run:
docker compose up -d
docker compose logs -f
Command line
You can also use the following minimal command:
docker run -d --name pure-ftpd \
-p 2100:2100 \
-p 30000-30009:30000-30009 \
-e "TZ=Europe/Paris" \
-v "$(pwd)/data:/data" \
crazymax/pure-ftpd
Upgrade
Pull the updated image and recreate the container:
docker compose pull
docker compose up -d
Notes
Flags
This image configures Pure-FTPd with command-line flags and does not read
/etc/pure-ftpd.conf. The startup script
sets the required flags. Add other options to /data/pureftpd.flags, one per
line:
-d
-d
--maxclientsperip 5
--minuid 100
--limitrecursion 10000:3
Restart the container after editing this file. See the upstream Pure-FTPd documentation for available options.
Secure mode
SECURE_MODE=true enables additional restrictions in the
startup script, including a limit of
five clients in total and per IP address, confinement to users' home
directories, blocked file renaming, and blocked reads and writes of dotfiles.
Set it to false to disable this group of flags.
[!IMPORTANT] Secure mode does not enable encryption. Configure TLS separately to protect credentials and file transfers.
PureDB authentication method
With PureDB authentication, the container creates
/data/pureftpd.passwd if it does not exist and rebuilds /data/pureftpd.pdb
from that password file at startup.
On the first start, the database is empty. Create a user with:
$ docker compose exec pureftpd pure-pw useradd foo -u 1003 -g 1005 -d /home/foo -m
Password:
Enter it again:
$ docker compose exec pureftpd pure-pw list
foo /home/foo/./
The command prompts for a password and creates the virtual FTP user foo
with UID 1003, GID 1005, and home directory /home/foo. The -d option
restricts the user to that directory. Choose IDs that match the ownership
of your mounted files.
[!TIP] Use
-mwhen adding, modifying or deleting users to update the PureDB database immediately. Otherwise, apply changes without restarting with:docker compose exec pureftpd pure-pw mkdb
See the upstream virtual user documentation for password changes, quotas and other account settings.
Persist FTP user home
Persist the user's home directory with a volume or bind mount. For the
previous example, add ./foo:/home/foo to the Compose configuration:
services:
pureftpd:
image: crazymax/pure-ftpd
container_name: pureftpd
ports:
- "2100:2100"
- "30000-30009:30000-30009"
volumes:
- "./data:/data"
- "./foo:/home/foo"
environment:
- "TZ=Europe/Paris"
- "AUTH_METHOD=puredb"
restart: always
MySQL authentication method
The MariaDB example demonstrates MySQL authentication.
Set AUTH_METHOD=mysql and provide a configuration file
at /data/pureftpd-mysql.conf before starting the FTP container.
The example initializes the database and users table when the database container starts with an empty data directory.
Create and inspect a user in the example MariaDB database:
$ docker compose exec db mariadb -u pureftpd -p'asupersecretpassword' -e "INSERT INTO users (User,Password,Uid,Gid,Dir) VALUES ('foo',ENCRYPT('test'),'1003','1005','/home/foo');" pureftpd
$ docker compose exec db mariadb -u pureftpd -p'asupersecretpassword' -e "SELECT * FROM users;" pureftpd
+------+---------------+------+------+-----------+
| User | Password | Uid | Gid | Dir |
+------+---------------+------+------+-----------+
| foo | Oo4cJdd1HNVA6 | 1003 | 1005 | /home/foo |
+------+---------------+------+------+-----------+
[!NOTE] This example creates
foowith UID1003, GID1005, home directory/home/foo, and passwordtest. It uses MariaDB'sENCRYPT()function withMYSQLCrypt crypt, as configured in the example.
See the upstream MySQL/MariaDB documentation for supported password hashes and per-user settings.
PostgreSQL authentication method
The PostgreSQL example demonstrates PostgreSQL
authentication. Set AUTH_METHOD=pgsql and provide a configuration file
at /data/pureftpd-pgsql.conf before starting the FTP container.
The example initializes the database and users table when the database container starts with an empty data directory.
Run the following SQL in the pureftpd database to create a user with a
hashed password and explicit UID and GID:
CREATE EXTENSION IF NOT EXISTS pgcrypto;
INSERT INTO "users" ("User", "Password", "Uid", "Gid", "Dir")
VALUES ('foo', crypt('mypassword', gen_salt('bf')), 1003, 1005, '/home/foo');
See the upstream PostgreSQL documentation for supported password hashes and per-user settings.
TLS connection
Place the certificate and its private key in /data/pureftpd.pem. If they
are in separate PEM files, concatenate them into this file.
Add a TLS mode to /data/pureftpd.flags. For example, to require encryption
for both login and file transfers:
--tls=3
The upstream TLS documentation defines these modes:
| Mode | Behavior |
|---|---|
0 |
Disable TLS (default). |
1 |
Allow both unencrypted and TLS connections. |
2 |
Require TLS for the control connection, including login. |
3 |
Require TLS for both control and data connections. |
[!IMPORTANT] The
--tlsflag requires a numeric value. A bare--tlscan cause a startup error. Restart the container after changing the flags or certificate.
For testing, generate a self-signed certificate with the following commands.
Replace ftp.example.com with the hostname your clients use:
mkdir -p data
docker run --rm -it --entrypoint openssl -v "$(pwd)/data:/data" crazymax/pure-ftpd dhparam -out /data/pureftpd-dhparams.pem 2048
docker run --rm -it --entrypoint openssl -v "$(pwd)/data:/data" crazymax/pure-ftpd req -x509 -nodes -newkey rsa:2048 -sha256 -days 365 -keyout /data/pureftpd.pem -out /data/pureftpd.pem -subj "/CN=ftp.example.com" -addext "subjectAltName=DNS:ftp.example.com"
Configure your FTP client to use explicit FTP over TLS (FTPS) on port
2100 (or the host port you published). The client connects to the FTP port
and requests TLS with AUTH TLS. With mode 3, enable encryption for data
connections in the client as well.
[!NOTE] A self-signed certificate is not trusted automatically. Verify it before trusting it in your FTP client, or use a certificate issued by a CA that your client trusts.
Logs
Logs are sent to stdout through socklog-overlay. Follow them with:
docker compose logs -f pureftpd
For more detail, add -d twice on separate lines in /data/pureftpd.flags
and restart the container.
Contributing
Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a PayPal donation to ensure this journey continues indefinitely!
Thanks again for your support, it is much appreciated! :pray:
License
MIT. See LICENSE for more details.
Explorer des projets similaires
Chargement…
