Pilot Version: This project is currently in active development and testing. Features may evolve as we work to improve the experience.

GridStorage Logo

GridStorage

The ultimate inventory management system. Start for free entirely on your device, or upgrade to deploy your own private synchronization server.

Free

Local Node

Perfect for standalone, secure on-device tracking.

  • No server required
  • 100% offline functionality
  • Instant setup
Download App (Beta)

*Available for internal testers only. You must be added to the approved list to open this link.

Early Access
Beta Program

Enterprise Node

Host your own data. Includes Web Dashboard testing.

  • Multi-device live sync
  • Self-hosted database
  • Built-in Web Dashboard
  • Unlimited scaling
View Early Access Details
Product Tour

See GridStorage in Action

Discover private, local-first inventory tracking and self-hosted live synchronization.

GridStorage Tour

Watch our quick overview.

Web Dashboard (Early Access)

The Enterprise Node doesn't just sync your mobile devices. Your self-hosted server is designed to automatically host and serve the fully-compiled Flutter Web Dashboard. The web interface is currently in a closed Beta phase for early testers.

Support Development

GridStorage is built with passion and dedication to private, local-first inventory management. If you like the project, consider buying us a coffee on Ko-fi!

Support on Ko-fi

Self-Hosted Data Node Setup

Welcome to the Enterprise setup. By running your own server, you retain 100% ownership and privacy over your inventory data. Your data never leaves your network.

Node v1.0.0 ~ 4.0 KB

Core Deployment Package

Download the official server deployment bundle. This package includes the configuration files required to run your private inventory node using Docker for mobile app synchronization.

Download Server Bundle (.zip)
Closed Beta

Web Dashboard Early Access

Want to manage your inventory from a desktop browser? The built-in Web Dashboard is currently in closed testing. Apply below to receive the separate Web Add-on package.

Apply via Email
Contact: gridstoragehelp@gmail.com Please include details about your hardware setup (e.g., QNAP, Windows Docker).

📋 Prerequisites

Before you begin, you need to have Docker installed on your computer or NAS.

Windows / Mac

Download and install Docker Desktop.

Get Docker Desktop

Linux / NAS

Install Docker and Compose via your package manager.

View Linux Docs

🟢 OPTION A: Quick Start

If you just want to get your server running as fast as possible without touching any code, use this method (1-Click Setup).

1

Download and Extract

Download the ZIP file above and extract it to a folder on your computer.

2

Run the Startup Script

Windows Users Double-click start_server.bat
Mac / Linux Users bash start_server.sh
3

Connect Your App & Web Dashboard

The script will automatically check your system, start the server, and display your Local IP Address.

  1. For Mobile: Open the GridStorage app, go to Server Configuration, and type the URL exactly as shown (e.g., http://192.168.0.50:3000).
  2. For PC/Mac: Type the same URL directly into any web browser. (Note: Web interface requires the Beta Web Add-on).
  3. Log in using the default credentials below.
Default Logins
Email: admin@gridstorage.com
Pass: admin123

Note: We highly recommend changing your password inside the app settings immediately after your first login.

🛠️ OPTION B: Advanced Setup

If you want full control over your security keys and database passwords before deploying, follow these manual steps.

Extract the ZIP file and open both files in a text editor to change the default credentials:

docker-compose.yml
# Change POSTGRES_PASSWORD:
POSTGRES_PASSWORD: "your_strong_password"
# Replace password in PGRST_DB_URI:
PGRST_DB_URI: "...authenticator:your_strong_password@db..."
# Change JWT_SECRET (must be at least 32 chars):
PGRST_JWT_SECRET: "your_new_random_32_character_string"
init-db.sql
-- Ensure the JWT secret matches EXACTLY with docker-compose:
DECLARE secret text := 'your_new_random_32_character_string';

Open your terminal, navigate to your extracted folder, and run:

docker-compose up -d

Wait about 15-20 seconds for the database to fully initialize.

To find your IP:

  • Windows: Open Command Prompt, type ipconfig, find IPv4 Address.
  • Mac: Go to System Settings > Network > Wi-Fi > Details to find IP.

🛑 Troubleshooting & FAQ

"Server is Unreachable"

Ensure your phone and your computer are connected to the exact same Wi-Fi network. If you are on Windows, ensure your Windows Defender Firewall allows inbound traffic on TCP Port 3000.

How do I reset my server?

Open a terminal in the server folder and run docker-compose down -v. Warning: This will permanently delete all your local inventory data! To start fresh, run docker-compose up -d again.

🔒 Privacy Policy

Your data privacy is fundamental to our architecture. This is a local-first application, meaning your inventory data is stored exclusively on your device or within your private self-hosted node. We do not have access to your database, your passwords, or your synced inventory items.

View Full Privacy Policy on GitHub