Marketplace Deployment

Infrastructure and deployment tooling for the Project Mycelium Marketplace.

Directory layout

deploy/
  single-vm/          # TFGrid single-VM deployment (OpenTofu + Docker Compose)
    envs/
      prod/            # Production environment config
      dev/             # Development environment config
    scripts/           # Setup and update scripts
    tf/                # OpenTofu (Terraform) modules
    Makefile           # Deployment commands (make update ENV=prod)
  k8s/                 # Kubernetes manifests (future)
  Containerfile.backend   # Backend container build
  Containerfile.admin     # Admin panel container build
  Makefile             # Top-level deploy commands

Quick start

Local Docker Compose (from project root)

# Start full stack (marketplace + hero_osis + hero_ledger + Caddy)
make local-up

# Verify
curl http://localhost:8000/api/health

# Stop
make local-down

Single-VM deployment (TFGrid)

cd single-vm

# 1. Configure credentials
cp envs/dev/app.env.example envs/dev/app.env
# Edit app.env with your settings

# 2. Full deploy
make all ENV=dev

# 3. Quick update (pull new image + restart)
make update ENV=dev

See single-vm/Makefile for all available targets.

Container images

Images are built from the Containerfiles in this directory and pushed to:

forge.ourworld.tf/mycelium_code/projectmycelium_marketplace

Tag	Source
:development	development branch
:latest	main branch or version tag
:vX.Y.Z	Git version tag

Building images manually

# Backend
podman build -f Containerfile.backend -t projectmycelium_marketplace:dev ..

# Admin
podman build -f Containerfile.admin -t marketplace_admin:dev ../admin

Environments

Environment	URL	Branch
Production	projectmycelium.org/marketplace/demo	main
Development (SSR)	dev.projectmycelium.org/marketplace/demo	development
Development (SPA)	dev-app.projectmycelium.org	development
Development (Admin)	dev-admin.projectmycelium.org	development
Local	localhost:8000	any

Documentation

• SPA Architecture — Dioxus frontend design, auth flow, API proxy, cart, deployment