ZitaFTP Server

ZitaFTP Server (pre-release) - free 30 day trial
================================================

ZitaFTP is a secure FTP server, which enables you to share files on
your computer with others.

IMPORTANT: This is a pre-release, which means that it is missing
features, and has "rough edges" (i.e., is not as polished as the final
release will be).

Changes in 1.33
---------------

- Added automatic SSL/TLS certificate generation and renewal via 
  Let's Encrypt and ZeroSSL
- Server settings UI wouldn't allow the maximum number of clients to
  be set to 0 (infinite). FIXED
- Server settings UI wasn't showing error messages immediately. FIXED
- Fixed a rare "SSL routines:ssl3_write_pending:bad write retry" error
  that could cause HTTP requests to be cut off
- Now recognizes HTTP proxy headers, so it won't treat proxy connections
  as local
- Local peer detection wasn't working properly for HTTPS connections.
  FIXED
- Fixed a possible SEGV fault if a receive error occurred before the
  start of an HTTP message (e.g., a client tries to establish an 
  HTTPS connection on an HTTP port)
- Fixed a silly bug that flipped the HTTP port number's endianness

Installing
----------

Simply run the included installer. It will also install any required
dependencies.

Getting Started
---------------

A configuration wizard will be shown the first time you run the
server. This will allow you to add users, directories, set basic
permissions, and generate a TLS security certificate.

The server will be started once configuration is complete. At that point
you can log on using any FTP client (that supports secure FTPS). To
connect from an FTP client on the same machine, enter "localhost" as the
target machine.

NOTE: With some FTP clients you need to choose "Explicit FTPS" (or 
similar) for secure connections. The alternative "implicit FTPS" is 
obsolete and unsupported.

Connecting from another machine is more complicated. You need to log 
on using one of the IP addresses shown at the end of the configuration 
wizard (or on the dashboard).

Accessing the User Interface (UI)
---------------------------------

ZitaFTP's web-based UI can be accessed by:
* Double-clicking on the docky/sys-tray icon
* Enter the UI's URL into your browser's address bar (e.g., 
  https://<your IP address>:<chosen port>/). Remote access from another 
  machine is possible if it was enabled during configuration

Command Line Parameters
-----------------------

The following command line parameters can be used when starting from the
console/shell: 
* --echolog - will print a copy of everything that's
logged to the console window (HINT: looks best with ANSI colours.
AmigaOS users can set this up from the shell window's settings) 
*    --loglevel <str> - overrides the config file's logging level. Valid
     values for <str> are: fatal, severe, error, warning, info, detail,
     extra_detail, debug, extreme_debug, all 
*    --help - prints help information

The Docky/Status-Icon
---------------------

The server's status is shown via a docky (a.k.a., status-icon). It will 
light up when the server is in use, and has upload & download status 
lights (which also double as an indicator for all file events including 
directory creation & deletion).

Shutting Down the Server
------------------------

ZitaFTP Server can be shut down via the docky/status-icon's popup menu. 

Changing the Server Configuration
---------------------------------

1. Edit the configuration file manually in a text editor (use the 
   docky/status-icon's popup menu to open it)
2. Delete the current configuration file (or rename it). The basic 
   configuration GUI will run next time the server is started

In both cases, you should restart the server, which can be done via the 
docky/status-icon's popup menu.

NOTE: A proper configuration UI is planned, but is not yet done.


Authors
-------

* Hans de Ruiter - https://keasigmadelta.com/about-us/the-founder/

License
-------

This project is Copyright (C) 2018-2020 by Kea Sigma Delta Limited, all
rights reserved. See the License.txt file for license
terms.

Acknowledgments
---------------

Thanks to those who helped improve this product by submitting bug 
reports:
- Alfredo Amendolagine
- Dave Koelman
- Janne Peraaho
- Paul E. Bloedel
- Roman Kargin

*   Thanks to the third-parties who wrote the software libraries on
    which this program is built. See the ThirdPartyLicenses/ directory
    for the licenses of these libraries