fold-stack/docs/usage.md

🛠 Usage Guide for Fold Stack (Dev)

This document outlines daily developer workflows for using the Fold Stack in development mode.

---

▶️ Start the Stack (Dev Mode)

Bring everything up in detached mode:

./scripts/up-dev.sh

Or manually:

docker compose -f docker-compose.dev.yml --env-file .env.dev up -d

---

⏹ Stop the Stack

Shut down all running containers:

docker compose -f docker-compose.dev.yml down

To also delete volumes (data):

docker compose -f docker-compose.dev.yml down -v

---

🔄 Rebuild Everything From Scratch

Wipe and rebuild:

docker compose -f docker-compose.dev.yml down -v
docker compose -f docker-compose.dev.yml up -d --build

---

🐚 Attach to a Running Container

docker exec -it forgejo_dev /bin/sh
docker exec -it ghost_dev /bin/sh
docker exec -it radicle_dev /bin/bash
docker exec -it pandoc_dev /bin/sh

---

🪵 View Logs

docker logs forgejo_dev
docker logs ghost_dev

---

🧹 Clean Everything

WARNING: Removes ALL Docker data.

docker system prune -a --volumes

---

🧪 Quick Test & Status

docker ps
docker compose -f docker-compose.dev.yml logs -f