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

- Overwriting a file wasn't truncating it back to 0 (i.e., overwriting with 
  a smaller file wouldn't change the file size). FIXED
- Now starts the GUI on-demand if the port number is 0 (i.e., the UI server
  isn't started until actually needed)
- Refactored some of the UI code to make building new UI pages and sub-pages
  easier
- Implemented the UI for creating, editing and deleting both users and 
  virtual directories

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

NOTE: A more substantial UI is planned, this is one of the features
missing from the pre-release.

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