FTPDav Installation and Administration Guide

Windows Installation

  • Use the download link on the previous page to download and run the installer
  • Open a browser to the default admin page http://localhost:6080
  • Create your administration account and password, and try out the browser interface, admin interface and test with ftp and webdav clients.

Unix Installation (walk through)

Here is a basic walk through for unix.
wget https://netwinsite.com/ftp/misc/ftpdav_setup.tar.gz
gunzip ftpdav_setup.tar.gz
tar -xvf ftpdav_setup.tar
cd ftpdav_setup
source install.sh

Then open your browser http://your.server:6080
If you have a firewall adjust it to permit the ports that FTPDAV wants to use (listed lower down)

If MONO fails

Most recent linux distributions include MONO, if you don't have it try adding it...
    apt-get update
    apt-get install mono-runtime
If that fails you may try to install it manually, or you may find your linux distribution is too old.

Recommended and or Tested WebDav clients

  • DAVE IOS/ipad/iphone
  • NetDrive (windows map drive, free for personal use)
  • (Let us know if you have a favorite we should add)

Recommended and or tested FTP clients

Using Windows WEBDAV Drive mapping.

The built in WEBDAV client in Windows Explorer is faulty, slow, and difficult to use (for example if you miss type your password it won't then allow you to correct your mistake without rebooting windows).  We strongly advise you to save yourself some grey hairs and install a proper one: e.g.  NetDrive Download

Then Map to your server using a url like:  http://your.server:6080/wd (or use https if you want the link secure!)

Adjust the ports if you do/don't have a web server on the same machine!

By default the server uses ports 80,443,6080,1080,1443

Web Administration Menu

The administration options are broken down into Users, Profile, and Config.  These options are only visible to the administrator, not to normal users!

  • Users - Use this to add/remove/modify user accounts
  • Profiles - Use this to map virtual directories to physical directories for users.
  • Config - Use this to specify/change the server setup (ports, hostname, quota, mail server, paypal)

PayPal Integration

Simply provide your paypal account details and you can make FTPDAV charge users for quota increases and the profits will go directly to your PAYPAL account. 

Getting an SSL certificate for your server

The server comes with a test certificate, but you will probably want a real one at some point!

For Windows

Download and install a certificate requestor and an opennssl utility if you don't have one.
    (certificate requestor) http://certrequestor.codeplex.com
    (openssl) http://www.shininglightpro.com/download/Win32OpenSSL_Light-1_0_1.exe

Run the certificate requestor.

  • Set bits to 2048
  • Set CSP Name to "Microsoft Strong Cryptographic Provider"
  • Set common name to your domain name of your server, e.g. ftpdav.company.com
  • Set your email address
  • Set Organization
  • Check BACKUP key to PFX file
  • Check Make private key exportable
  • Save your 'csr' file to c:\ftpdav\ssl\mykey.csr (Use this file when when asked for your CSR) 
  • Save your private key, pfx file to c:\ftpdav\ssl\private.pfx (don't specify a password)

Pay for a SSL certificate, you can get one here for $10 :-)  https://www.namecheap.com (use your CSR from above)

They will send you a bunch of files typically something *.crt or *pem files...
    your_domain.crt
    rootca.crt

Save all these files in \ftpdav\ssl

Now you need to combine all these files to make a PFX file for your server. These commands turn your private key into a pem file, then combines the pem/crt files, then turns the result back into a pfx file.        

cd \ftpdav\ssl
openssl.exe pkcs12 -in private.pfx -out private.pem -passin pass: -passout pass:test
openssl.exe rsa -in private.pem -out private.key -passin pass:test
copy your_domain.crt + rootca.crt + private.key all.crt
openssl pkcs12 -export -out server.pfx -in all.crt -passout pass:secret

All going well, you now have a nice working server.pfx file, now just restart ftpdav and try it :-)

For Unix (a key created like this will also work on windows)

Generate  a CSR   

cd /var/ftpdav/ssl

# create private key and csr request, when it asks for your COMMON NAME, give DNS name of server!
openssl req -nodes -newkey rsa:2048 -keyout private.key -out mykey.csr -passout pass:
Common Name? ftpdav.your.domain

# self sign your private key so your server will work while waiting for the real key...
openssl x509 -req -days 1365 -in mykey.csr -signkey private.key -out server.crt
cat server.crt private.key >all.crt

# create sever.pfx from our private key and csr etc...
openssl pkcs12 -export -out server.pfx -in all.crt -passout pass:secret

Pay for a SSL certificate and give them the contents of mykey.csr, they will give you some '.crt' files back, build a new server.pfx from these files like this:

cat your_domain.crt rootca.crt private.key >all.crt
openssl pkcs12 -export -out server.pfx -in all.crt -passout pass:secret

If you use a password other than 'secret' then you must set it in your config settings to match. (a password is required on .pfx file or it won't work)