[][src]Crate libunftp

libunftp is an extensible, async, cloud orientated FTP(S) server library.

Because of its plug-able authentication (PAM, JSON File, Generic REST) and storage backends (e.g. local filesystem, Google Cloud Storage) it's more flexible than traditional FTP servers and a perfect match for the cloud.

It runs on top of the Tokio asynchronous run-time and tries to make use of Async IO as much as possible.

Quick Start

Add the libunftp and tokio crates to your project's dependencies in Cargo.toml

libunftp = "0.16.0"
tokio = { version = "1", features = ["full"] }

Now you're ready to develop your server! Add the following to src/main.rs:

pub async fn main() {
    let ftp_home = std::env::temp_dir();
    let server = libunftp::Server::with_fs(ftp_home)
        .greeting("Welcome to my FTP server")


You can now run your server with cargo run and connect to localhost:2121 with your favourite FTP client e.g.:

lftp -p 2121 localhost



Contains the Authenticator and UserDetail traits that are used by various implementations and also the Server to authenticate users.


Contains code pertaining to the setup options that can be given to the Server


Contains the StorageBackend trait and its bundled implementations that can used by the Server.



An instance of an FTP(S) server. It aggregates an Authenticator implementation that will be used for authentication, and a StorageBackend implementation that will be used as the virtual file system.


Error returned by the Server.listen method