PURE-FTPD-WRAPPER(8)

💖 PURE-FTPD-WRAPPER(8) 💖

okay bestie, so this is the pure-ftpd-wrapper page from the Debian GNU/Linux Documentation section 8 — yes, the big-girl system administration section, she's giving main character energy fr fr 👑

---

✨ NAME ✨

pure-ftpd-wrapper — configures and starts the Pure-FTPd daemon 🌸

---

🎀 SYNOPSIS 🎀

pure-ftpd-wrapper

that's it. that's the whole synopsis. no args, no flags, just vibes 💅

---

🦋 DESCRIPTION 🦋

So pure-ftpd-wrapper is the little bestie that reads your Pure-FTPd daemon config from the files sitting in the directory /etc/pure-ftpd/conf. Every single file in there maps to one command line option — one file, one option, that's the rule 💖. And listen: no more than one line with configuration values is allowed per file. Empty lines? Discarded. Lines starting with the comment character #? Also discarded. bye 👋

Now here's the cute part ✨ — the Pure-FTPd daemon lets you use different authentication methods together, and it tries them in the order they're specified on the command line. To get that same flexibility out of plain files, pure-ftpd-wrapper checks all the valid symbolic links inside the directory /etc/pure-ftpd/auth — in alphabetical order (iconic, organized, we love her) 🎀.

So like, a link in that directory pointing to /etc/pure-ftpd/conf/PureDB would enable authentication against a PureDB database. iykyk 🫶

lowkey important: there are no means to configure the PIDFile setting. It's hardwired to /var/run/pure-ftpd/pure-ftpd.pid in this script. periodt. 💀

Wanna see the actual Pure-FTPd commandline options? You can display them with -s or --show-options:

pure-ftpd-wrapper --show-options

obsessed with a good debug flag honestly 😭

---

🌈 CONFIGURATION 🌈

🍓 Boolean values 🍓

The strings "Yes", 1, "On" enable the corresponding commandline option — and case doesn't matter, so go feral with your capitalization bestie 🙈. To disable the option use "No", 0 or "Off".

The configuration files that contain boolean values are:

• "AllowAnonymousFXP"
• "AllowDotFiles"
• "AllowUserFXP"
• "AnonymousCanCreateDirs"
• "AnonymousCantUpload"
• "AnonymousOnly"
• "AntiWarez"
• "AutoRename"
• "BrokenClientsCompatibility"
• "CallUploadScript"
• "ChrootEveryone"
• "CreateHomeDir"
• "CustomerProof"
• "Daemonize"
• "DisplayDotFiles"
• "DontResolve"
• "IPV4Only"
• "IPV6Only"
• "KeepAllFiles"
• "LogPID"
• "NATmode"
• "NoAnonymous"
• "NoChmod"
• "NoRename"
• "NoTruncate"
• "PAMAuthentication"
• "ProhibitDotFilesRead"
• "ProhibitDotFilesWrite"
• "UnixAuthentication"
• "VerboseLog"

---

🔢 Numerical values 🔢

There are several types of numerical values, and they are: one number, two numbers, one or two numbers, and two octal numbers. pick your fighter 💅

One number

• "MaxClientsNumber"
• "MaxClientsPerIP"
• "MaxDiskUsage"
• "MaxIdleTime"
• "MaxLoad"
• "MinUID"
• "TLS"
• "TrustedGID"

Two numbers

• "AnonymousRatio"
• "LimitRecursion"
• "PassivePortRange"
• "PerUserLimits"
• "Quota"
• "UserRatio"

Two numbers (with unlimited value) ✨

This one is extra special because it allows -1 in addition to positive numbers — and -1 means an unlimited value. go big or go home 🫶

• "LimitRecursion"

One or two numbers

• "AnonymousBandwidth"
• "UserBandwidth"

Two octal numbers

• "Umask"

---

🌸 String values 🌸

Arbitrary strings

• "AltLog"
• "Bind"
• "ForcePassiveIP"

(yes, the original page spells it "Arbritrary" — we're keeping her exactly as she is, no editing the queen 💖)

Words

• "SyslogFacility"

---

🧚 Character Sets 🧚

• "FSCharset"
• "ClientCharset"

⚠️ heads up bestie: these options were removed from PureFTPd in release 1.0.48 and will be ignored by the wrapper. not deprecated, just straight up gone 😭

---

💜 IP values 💜

• "TrustedIP"

---

👑 File values 👑

These values designate an existing file or socket — so like, it has to actually exist, no manifesting ✨

File

• "FortunesFile"
• "LDAPConfigFile"
• "MySQLConfigFile"
• "PGSQLConfigFile"
• "PureDB"

Socket

• "ExtAuth"

---

💌 AUTHOR 💌

This manual page was written by Stefan Hornburg (Racke) <racke@linuxia.de> for the Debian GNU/Linux system. absolute legend, we stan a documentation king 🫶👑

---

and that's the whole page babes 🌈 this one shipped with Debian GNU/Linux bookworm/sid, dated 2022-01-31, and it's still giving PURE-FTPD-WRAPPER(8) energy. go configure something slay 💅💖