Stack Lab

A local development environment for managing decentralized services.

Setup

1. Prerequisites:

   • Docker Desktop or OrbStack
   • Python 3.9+

2. Initialize Environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

3. Start Services:

   docker compose up -d

   This starts MinIO on ports 9000 (API) and 9001 (Console).

Usage

Dashboard

Run the Streamlit dashboard to view service status:

• Terminal: streamlit run dashboard.py
• Launcher: Double-click Start Stack Lab.command on your Desktop or in the project folder.

Network Access

To access the dashboard from other devices on your local network:

• URL: http://stacklab.local (default port 80)
• Note: Ensure your firewall allows incoming connections to port 80.

Rules

• MinIO: S3-compatible storage.
• n8n: Workflow automation tool.
• Qdrant: Vector Database for AI applications.
• ClickHouse: Analytics database (ports 8123, 9000).
• PostgreSQL: Relational database (port 5432).
• Nexus3: Artifact repository manager (port 8081).
• Jupyter: Python notebook environment (port 8888).
• Gogs: Self-hosted Git service (port 3000, SSH 10022).
• Data Persistence: Use local volume mappings in ./[service_name]_data.