oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
aitbc/README-DOMAIN-DEPLOYMENT.md
oib ff5486fe08 ``` 
chore: refactor logging module, update genesis timestamp, remove model relationships, and reorganize routers

- Rename logging.py to logger.py and update import paths in poa.py and main.py
- Update devnet genesis timestamp to 1766828620
- Remove SQLModel Relationship declarations from Block, Transaction, and Receipt models
- Add SessionDep type alias and get_session dependency in coordinator-api deps
- Reorganize coordinator-api routers: replace explorer/registry with exchange, users, marketplace
2025-12-28 21:05:53 +01:00

3.0 KiB
Raw Blame History

AITBC Domain Deployment Guide

Overview

Deploy AITBC services to your existing domain: https://aitbc.bubuit.net

Service URLs

Prerequisites

  1. Incus access (add user to incus group):
sudo usermod -aG incus $USER
# Log out and back in
  1. Domain pointing to your server

Deployment Steps

1. Deploy Services

./deploy-domain.sh

2. Configure Port Forwarding

Forward these ports to the container IP (10.1.223.93):

  • Port 80 → 10.1.223.93:80
  • Port 443 → 10.1.223.93:443

3. Install SSL Certificate

incus exec aitbc -- certbot --nginx -d aitbc.bubuit.net

4. Verify Services

Visit the URLs to ensure everything is working.

Nginx Configuration

The nginx configuration handles:

  • HTTPS redirection
  • SSL termination
  • Path-based routing
  • API proxying
  • Security headers

Configuration file: /home/oib/windsurf/aitbc/nginx-aitbc.conf

Service Management

Check running services:

incus exec aitbc -- ps aux | grep python

View logs:

incus exec aitbc -- journalctl -u aitbc-coordinator -f

Restart services:

incus exec aitbc -- pkill -f uvicorn
incus exec aitbc -- /home/oib/start_aitbc.sh

Update nginx config:

incus file push nginx-aitbc.conf aitbc/etc/nginx/sites-available/aitbc
incus exec aitbc -- nginx -t && incus exec aitbc -- systemctl reload nginx

API Endpoints

Coordinator API

  • GET /api/marketplace/offers - List GPU offers
  • POST /api/miners/register - Register miner
  • POST /api/marketplace/bids - Create bid
  • GET /api/marketplace/stats - Marketplace stats

Blockchain RPC

  • GET /rpc/head - Get latest block
  • GET /rpc/getBalance/{address} - Get balance
  • POST /rpc/admin/mintFaucet - Mint tokens

Security Considerations

  1. Firewall: Only open necessary ports (80, 443)
  2. SSL: Always use HTTPS
  3. API Keys: Use environment variables for sensitive keys
  4. Rate Limiting: Configure nginx rate limiting if needed

Monitoring

Health checks:

Metrics:

Troubleshooting

Services not accessible:

  1. Check port forwarding
  2. Verify nginx configuration
  3. Check container services

SSL issues:

  1. Renew certificate: incus exec aitbc -- certbot renew
  2. Check nginx SSL config

API errors:

  1. Check service logs
  2. Verify API endpoints
  3. Check CORS settings

Customization

Add new service:

  1. Update nginx-aitbc.conf
  2. Add service to start_aitbc.sh
  3. Restart services

Update UI:

  1. Modify HTML files in apps/
  2. Update base href if needed
  3. Restart web servers

Production Tips

  1. Set up monitoring alerts
  2. Configure backups
  3. Use environment variables for config
  4. Set up log rotation
  5. Monitor resource usage