lfg2025/archy
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases 44 Wiki Activity
archy/QUICK_REFERENCE_DOCKER.md
Dorian 7afefafec1 Update README and API for Docker integration and app management 
- Revised README.md to clarify the use of Docker alongside Podman for containerization.
- Updated API documentation to reflect new RPC endpoints, including `auth.logout`.
- Enhanced WebSocket handling in the API for better connection management.
- Modified Neode UI to utilize a curated list of Docker-based applications, replacing previous Start9 registry calls.
- Improved error handling and logging in the marketplace for better user experience.
2026-01-27 22:55:20 +00:00

3.6 KiB
Raw Blame History

Archipelago Docker Dev - Quick Reference

🚀 Quick Start

cd neode-ui
npm start    # Start everything (Docker + UI)

Open: http://localhost:8100

🛑 Stop Everything

cd neode-ui
npm stop     # Stop all containers + UI

📱 App URLs

App URL Default Creds
Neode UI http://localhost:8100 -
Grafana http://localhost:3000 admin/admin
Home Assistant http://localhost:8123 (create on first run)
Mempool http://localhost:4080 -
SearXNG http://localhost:8082 -
Penpot http://localhost:9001 (create account)
OnlyOffice http://localhost:8083 -
BTCPay Server http://localhost:14142 (setup on first run)
Ollama API http://localhost:11434 -
Endurain http://localhost:8084 (placeholder)
MorphOS http://localhost:8081 (placeholder)

🐳 Docker Commands

# View all containers
docker compose ps

# View logs
docker compose logs -f            # All logs
docker compose logs -f bitcoin    # Specific app

# Control containers
docker compose stop bitcoin       # Stop one app
docker compose start bitcoin      # Start one app  
docker compose restart lnd        # Restart one app

# Status check
docker compose ps                 # Running containers
docker stats                      # Resource usage

# Fresh start
docker compose down -v            # Delete all data
docker compose up -d              # Start everything

🔧 Troubleshooting

App won't load

docker compose ps                 # Check if running
docker compose logs bitcoin       # Check logs
docker compose restart bitcoin    # Try restart

Port conflict

lsof -i :8123                    # Find what's using port
docker compose stop              # Stop all containers

Out of space

docker system prune -a           # Clean up everything

Complete reset

npm stop
docker compose down -v
docker system prune -a
npm start

💡 Development Tips

First run

  • Takes 10-30 min to download images
  • ~3-5GB of images
  • You'll be prompted to confirm

Making UI changes

  • Files auto-reload on save
  • Edit in neode-ui/src/

Testing Bitcoin

# Generate regtest blocks
docker exec archy-bitcoin bitcoin-cli -regtest \
  -rpcuser=bitcoin -rpcpassword=bitcoinpass \
  generatetoaddress 101 [address]

View specific logs

docker compose logs -f --tail=100 bitcoin

Check resource usage

docker stats

📁 Project Structure

archy/
├── docker-compose.yml          # All apps defined here
├── start-docker-apps.sh        # Start script
├── stop-docker-apps.sh         # Stop script
├── GETTING_STARTED.md          # Full guide
├── DOCKER_DEV_SETUP.md         # Technical docs
└── neode-ui/
    ├── start-dev.sh            # npm start
    ├── stop-dev.sh             # npm stop
    └── src/
        ├── views/Apps.vue      # My Apps page
        └── utils/dummyApps.ts  # App definitions

📚 Documentation

⚡ Common Tasks

Update images

docker compose pull
docker compose up -d

Backup data

docker compose down
cp -r /var/lib/docker/volumes ~/docker-backup

Add new app

  1. Edit docker-compose.yml
  2. Edit neode-ui/src/utils/dummyApps.ts
  3. Run npm stop && npm start

Need help? See GETTING_STARTED.md