README.md

Deployment Guide

This guide covers deploying Mycelium Cloud in different environments.

Deployment Options

• Local Development - Single machine setup
• Docker Compose - Multi-container orchestration
• Kubernetes - Production-grade deployment
• TFGrid - Decentralized infrastructure

Quick Start

Local Development

cd backend && make run
cd ../frontend/kubecloud && npm run dev

Docker Compose

cp backend/config-example.json backend/config.json
docker-compose up

Environment Configuration

Create configuration files in the root directory:

• backend/config.json - Backend configuration
• frontend/kubecloud/.env - Frontend environment variables
• prod_config.json - Production configuration

Copy from example files:

cp backend/config-example.json backend/config.json
cp frontend/kubecloud/env.example frontend/kubecloud/.env

Service Access

Service	Local Dev	Docker
Frontend	http://localhost:5173	http://localhost:8000
Backend API	http://localhost:8080	http://localhost:8080
Grafana	http://localhost:3000	http://localhost:3000
Prometheus	http://localhost:9090	http://localhost:9090

Prerequisites

• Go 1.19+
• Node.js 20+
• Docker & Docker Compose
• Git

Documentation

• Local Development Setup
• Docker Compose Guide
• Kubernetes Deployment
• TFGrid Deployment

Troubleshooting

Port Conflicts

# Find process using port 8080
lsof -i :8080
# Kill process
kill -9 <PID>

Docker Issues

# Clear everything and rebuild
docker-compose down -v
docker-compose up --build

Database Issues

• Verify credentials in config
• Check database is running
• Review logs for errors

Next Steps

1. Choose your deployment method
2. Follow the specific deployment guide
3. Configure environment variables
4. Start the services
5. Access the application

Support

• Getting Started Guide
• Architecture Overview
• Report Issues