cloudvista/README.md

CloudVista

CloudVista is a simple cloud file storage site that allows users to register, login, upload, download, and delete files.

Features

• Files are not encrypted - they are stored as-is in the storage directory
• User directories are created using MD5 hashes of usernames
• Password hashes are created using MD5
• Files are stored in a designated STORAGE_ROOT directory (default: /var/www/storage)
• 1GB file size limit per upload
• Cookie-based session management (30-day expiration)
• Users can change their password
• Users can delete their account (which removes all files)

Setup & Configuration

Configuration is done by editing the variables in the cloudvista.cgi script:

my $STORAGE_ROOT = "/var/www/storage"; # must be writable by httpd user
my $MAX_UPLOAD   = 1073741824;         # 1 GB
my $SCRIPT_NAME  = $ENV{SCRIPT_NAME} || "/cgi-bin/cloudvista.cgi";
my $COOKIE_DAYS  = 30;

Requirements

• Perl 5.8+ with core modules
• A web server with CGI support (Apache, Nginx with CGI wrapper, etc.)
• The storage directory must be writable by the web server user

Installation

1. Place cloudvista.cgi in your web server's CGI directory
2. Make it executable: chmod 755 cloudvista.cgi
3. Create and configure the storage directory:

   mkdir -p /var/www/storage
   chown www-data:www-data /var/www/storage  # adjust user for your web server
   chmod 750 /var/www/storage
   

4. Update $STORAGE_ROOT in the script if needed
5. Access via your web server's CGI endpoint

Usage

Users can:

• Register a new account with username and password
• Login to access their file storage
• Upload files (up to 1GB each)
• Download their files
• Delete individual files
• Change their password
• Delete their account and all files