CloudHost TUI

A secure file server with a terminal user interface (TUI) that helps users host their files locally with a modern web interface and REST API.

This is the TUI version of CloudHost - featuring a terminal user interface with vim-like navigation for management and a web interface for file browsing with JWT-based authentication.

Installation

Option 1: Pre-built binary (Recommended)

Download the latest release from GitHub Releases

Windows Defender Warning

If Windows Defender shows a virus warning:

1. Click "More info"
2. Click "Run anyway"
3. Or add an exception in Windows Security

This is a false positive. The source code is available for inspection.

Option 2: Build from source

git clone https://github.com/StepanZagray/cloudhost-tui.git
cd cloudhost-tui

# Build the TUI application
cargo build --release
./target/release/cloudhost-tui

Option 3: Install via cargo

cargo install --git https://github.com/StepanZagray/cloudhost-tui.git --bin cloudhost-tui
cloudhost-tui

Setup

Local

1. Create Cloud Folders: In the Folders tab, create folders that link to your local directories
2. Create Cloud: Select the folders you want to include and create a cloud (group of folders that will be served together)
3. Set Password: Set a secure password for your cloud
4. Start Server: Go to the Clouds tab and start your cloud server
5. Access Files: Use the provided URL to access your files via web browser

Web Interface

• Main Dashboard: http://localhost:PORT/ - Lists all cloud folders
• File Browser: http://localhost:PORT/web/{cloud_folder_name}/files - Browse files in a specific cloud folder
• Login: http://localhost:PORT/login - Secure login with your cloud password

Internet Access

1. Complete the local setup steps above
2. Download cloudflared from Cloudflare
3. Set up a Cloudflare tunnel:
   • Follow the official documentation
   • Or use the generic tunnel domain: cloudflared tunnel --url http://localhost:PORT
4. Access your files via the provided Cloudflare tunnel URL

To-Do features:

• passwords with different permissions(download only, all)
• make it possible to share cloudfolders on several devices, and sync files between them