============================================================
EASY FILE SERVER - DEPLOYMENT GUIDE
============================================================

Thank you for using Easy File Server. This is a secure, open-source file 
storage solution built with Python.

------------------------------------------------------------
1. PREREQUISITES
------------------------------------------------------------
Before you begin, you need to have Python installed on your computer.

[WINDOWS]
1. Download Python from https://www.python.org/downloads/
2. Run the installer.
3. IMPORTANT: Check the box "Add Python to PATH" at the bottom of the 
   installer window before clicking "Install Now".

[LINUX (Ubuntu/Debian)]
Run these commands in your terminal:
sudo apt update
sudo apt install python3 python3-pip python3-venv

[MAC OS]
Install via Homebrew: brew install python
Or download from python.org.

------------------------------------------------------------
2. INSTALLATION
------------------------------------------------------------

STEP 1: UNZIP
Extract the "EasyFileServer_Source.zip" file to a folder on your computer 
(e.g., C:\EasyFileServer).

STEP 2: INSTALL DEPENDENCIES
Open your Command Prompt (Windows) or Terminal (Mac/Linux) and navigate 
to the project folder.

Run the following command to install the required libraries:
pip install -r requirements.txt

(Note: If 'pip' is not recognized on Windows, try 'python -m pip install -r requirements.txt')


------------------------------------------------------------
3. RUNNING THE SERVER
------------------------------------------------------------
To start the server, run the following command in your terminal/cmd:

python app.py

If successful, you will see a message:
"Server started at http://localhost:8888"

Open your web browser and go to: http://localhost:8888

------------------------------------------------------------
4. FIRST LOGIN (DEFAULT ADMIN)
------------------------------------------------------------
The system automatically creates an Administrator account the first time 
you run it.

Email:    admin@example.com
Password: admin123

IMPORTANT: Log in immediately and change this password in the "Settings" 
or "Admin Panel".

------------------------------------------------------------
5. CONFIGURATION (OPTIONAL)
------------------------------------------------------------
You can edit the 'config.py' file to change system settings.

[SMTP EMAIL SETTINGS]
To allow the "Forgot Password" feature to work, you must configure an 
email account (like Gmail) in 'config.py'.
- Set SMTP_USER to your email address.
- Set SMTP_PASS to your App Password (not your login password).

[HTTPS / SSL]
To make the server secure (HTTPS):
1. Get 'ServerCert.pem' and 'ServerKey.pem' files.
2. Put them in the project folder.
3. Change SSL_ENABLED = True in 'config.py'.

------------------------------------------------------------
TROUBLESHOOTING
------------------------------------------------------------

Issue: "pip" command not found.
Fix:   Reinstall Python and make sure to check "Add Python to PATH".

Issue: Email sending fails with "Authentication Failed".
Fix:   If using Gmail, you cannot use your normal password. You must 
       enable 2-Step Verification and generate an "App Password" in 
       your Google Account settings. Use that App Password in config.py.

============================================================
Easy File Server - Open Source Project
============================================================