Telegram Drive Web

Telegram Drive Web is a self-hosted web-based port of Telegram-Drive. It transforms your Telegram account into an unlimited, secure cloud storage drive, built with a Node.js (Express + gram.js) backend and a premium React (Vite + TypeScript) frontend.

Features

• Unlimited Cloud Storage: Harness the power of Telegram's infrastructure to store files of any size.
• Two-Layer Access Protection:
  • Web Access Password: Secures the web UI with a lock screen (essential when hosting on public domains).
  • Dynamic Telegram Auth: Log in natively on the Web UI using either a QR Code Scan or Phone Number & OTP.
• Interactive API Configuration: Input your custom TELEGRAM_API_ID and TELEGRAM_API_HASH directly on the login screen. No need to hardcode credentials or rebuild containers.
• Flexible Theme Control: Toggle between premium dark-mode (default glassmorphism) and light-mode themes dynamically.
• Dynamic File Sharing: Generate secure public sharing links with:
  • Optional password protection.
  • Custom link expiration boundaries (e.g. 1 hour, 1 day, 7 days, custom hours, or never).
  • Streamed public downloads directly via the server (bypasses admin portal credentials).
• Folder / Channel Context Menu:
  • Rename and Delete folders (channels).
  • Toggle folder publicity between public (with custom username @my_folder) and private.
  • Export and copy invite links.
• Fast Navigation Caching: Powered by SQLite (sql.js) to cache file/folder metadata, reducing Telegram API rate limits.
• Docker Ready: Multi-stage Dockerfile and docker-compose.yml for quick and containerized deployment.

---

Universal Deployment & Installation

Option 1: Docker Compose (Recommended)

Docker Compose is the easiest way to deploy the application on any platform (Linux, macOS, Windows, or NAS OS like CasaOS).

1. Create a project directory:

   mkdir telegram-drive-web
   cd telegram-drive-web

2. Create a .env file in the directory to set up the Access Password for the Web UI:

   ACCESS_PASSWORD=your_secure_web_ui_password

3. Create a docker-compose.yml file:

   services:
     telegram-drive:
       image: irnhakim/telegram-drive-web:latest
       container_name: telegram-drive-web
       restart: unless-stopped
       ports:
         - "3001:3001"
       environment:
         - ACCESS_PASSWORD=${ACCESS_PASSWORD}
       volumes:
         - telegram-drive-data:/app/data
   
   volumes:
     telegram-drive-data:
       driver: local

4. Start the container:

   docker compose up -d

5. Access the Web UI by navigating to http://<your-server-ip>:3001.

---

Option 2: Native Node.js Installation

1. Clone the repository and install dependencies for both the frontend and backend:

   # Clone repository
   git clone https://github.com/caamer20/Telegram-Drive.git # (or your fork repository URL)
   cd Telegram-Drive-WebServer
   
   # Set up backend
   cd server
   npm install
   npm run build
   
   # Set up frontend
   cd ../client
   npm install
   npm run build

2. Create a .env file in the root of the server directory:

   ACCESS_PASSWORD=your_secure_web_ui_password
   PORT=3001

3. Start the production server:

   cd ../server
   npm start

4. Open your browser and navigate to http://localhost:3001.

---

Local Development Setup

To run client and server concurrently with hot reloading:

1. Configure the .env file in the root workspace directory.
2. Run the backend server in development mode:

   cd server
   npm run dev

3. In a separate terminal, start the Vite development server:

   cd client
   npm run dev

4. Access the development environment at http://localhost:5173.

License

This project is licensed under the MIT License - see the LICENSE file for details.