8storage

8Storage 🚀

8Storage is a modern, self-hosted, multi-account Google Drive storage manager. It aggregates multiple free Google Drive accounts (15GB each) into a single large, virtual storage pool, allowing you to upload files larger than 15GB by automatically chunking, encrypting, and distributing them across your connected accounts.

---

Key Features

• Storage Pooling: Merge multiple Google Drive accounts into one combined virtual drive.
• Auto Chunking & Routing: Automatically split large files and route chunks sequentially or via round-robin.
• Native File Indexer: Scan and access files existing on your linked accounts that weren't uploaded through 8Storage.
• Secure Share Links: Generate public download links with custom expiration times (1 hour to 30 days).
• Modern User Interface: Premium dark-mode dashboard with real-time upload progress tracking.

---

Installation & Setup

You can run 8Storage using either the NPM global installer or Docker.

Method 1: NPM Global Installation (Recommended)

This method registers a global command 8storage and manages isolated Python packages in your user home directory automatically.

1. Install the package globally: Run:

   npm i -g 8storage
   

2. Run the application: Start the application from anywhere on your terminal:

   8storage
   

3. Access the application: The launcher will automatically open http://localhost:20151 in your web browser once Uvicorn starts.

---

Method 2: Docker Compose

If you prefer containerized deployment (includes Nginx for serving assets on port 80):

1. Make sure you have Docker and Docker Compose installed and running.
2. Run the startup command:

   docker compose up -d --build
   

3. Open http://localhost in your web browser.

---

First-Time Configuration Guide

Follow these steps to configure Google Drive access after launching the application:

Step 1: Log In

• Go to the web dashboard.
• Enter the default application password: 123456
• (Highly Recommended: Change this password immediately under Settings)

Step 2: Create Google Cloud OAuth Credentials

To link Google Drive accounts, you need to create a project on the Google Cloud Console:

1. Go to the Google Cloud Console.
2. Create a new project.
3. Enable the Google Drive API for your project.
4. Configure the OAuth Consent Screen:
   • Select External user type.
   • Add the scope: https://www.googleapis.com/auth/drive (Full access to Drive files).
   • Add your Google Accounts as Test Users (since the app is in testing/draft mode).
5. Go to Credentials -> Create Credentials -> OAuth Client ID:
   • Application type: Web Application.
   • Authorized redirect URI: http://localhost:20151/api/auth/callback
6. Copy the generated Client ID and Client Secret.

Step 3: Configure 8Storage Settings

1. In the 8Storage dashboard, click Settings on the left menu.
2. Paste your Google Client ID and Client Secret into the fields.
3. Click Save Settings.

Step 4: Link Your Google Drive Accounts

1. Click Virtual Drives in the sidebar.
2. Click Connect GDrive Account.
3. Log in with your Google account and grant the requested permissions.
4. Repeat this for as many Google Accounts as you'd like to pool together!