---
name: "pure-ftpd-wrapper"
section: "8"
platform: "linux"
package: "pure-ftpd-common"
version: "1.0.50-2.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pure-ftpd-wrapper"
---

# pure-ftpd-wrapper(8)

configures and starts Pure-FTPd daemon

## NAME

pure-ftpd-wrapper - configures and starts Pure-FTPd daemon

## SYNOPSIS

pure-ftpd-wrapper

## DESCRIPTION

**pure-ftpd-wrapper** reads the configuration for the Pure-FTPd daemon from files in the directory */etc/pure-ftpd/conf*. Each file in this directory is related to a command line option. No more than one line with configuration values is allowed. Empty lines or lines starting with the comment character `"#"` are discarded.

The Pure-FTPd daemon allows one to use different authentication methods together. The authentication methods are tried in the order they are specified on the command line. In order to achieve the same flexibility with files in the */etc/pure-ftpd* directory, **pure-ftpd-wrapper** checks all valid symbolic links within the directory */etc/pure-ftpd/auth* in alphabetical order. E.g., a link in this directory pointing to */etc/pure-ftpd/conf/PureDB* would enable authentication against a PureDB database.

There are no means to configure the *PIDFile* setting, it is hardwired to /var/run/pure-ftpd/pure-ftpd.pid in this script.

You can display the Pure-FTPd commandline options with `"-s"` or `"--show-options"`:

```
    pure-ftpd-wrapper --show-options
```

## CONFIGURATION

### Boolean values

The strings `"Yes"`,`1`,`"On"` enable the corresponding commandline option (case doesn't matter). To disable the option use `"No"`,`0` or `"Off"`.

Configuration files containing 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"` and `"VerboseLog"`.

### Numerical values

There are several types of numerical values (one number, two numbers, one or two numbers, two octal numbers).

- One number

  `"MaxClientsNumber"`, `"MaxClientsPerIP"`, `"MaxDiskUsage"`, `"MaxIdleTime"`, `"MaxLoad"`, `"MinUID"`, `"TLS"`, `"TrustedGID"`.

- Two numbers

  `"AnonymousRatio"`, `"LimitRecursion"`, `"PassivePortRange"`,  `"PerUserLimits"`, `"Quota"`, `"UserRatio"`.

- Two numbers (with unlimited value)

  This allows -1 in addition to positive numbers indicating an unlimited values.

  `"LimitRecursion"`.

- One or two numbers

  `"AnonymousBandwidth"`, `"UserBandwidth"`.

- Two octal numbers

  `"Umask"`.

### String values

- Arbritrary strings

  `"AltLog"`, `"Bind"`, `"ForcePassiveIP"`.

- Words

  `"SyslogFacility"`.

### Character Sets

`"FSCharset"`, `"ClientCharset"`.

These options were removed from PureFTPd in release 1.0.48 and will be ignored by the wrapper.

### IP values

`"TrustedIP"`.

### File values

These values designate an existing file or socket.

- 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.