randebu/deployment/DEPLOYMENT.md

Deployment Guide

This document describes how to deploy the Randebu Trading Bot application to a production server.

Prerequisites

• Debian server with 8GB RAM, 4 cores
• Python 3.10+
• Node.js 18+
• Nginx
• SSL certificate (Let's Encrypt)
• SSH access to server

Server Structure

/var/www/
  └── bot/
      ├── backend/          # Backend application (FastAPI)
      ├── frontend/         # Frontend static files (SvelteKit build)
      └── data/             # SQLite database and app data

Step-by-Step Deployment

1. Clone Repository

ssh user@your-server
sudo mkdir -p /var/www/bot
sudo chown -R $USER:$USER /var/www/bot
cd /var/www/bot
git clone https://git.fbrns.co/shoko/randebu.git .

2. Setup Backend

cd /var/www/bot/src/backend

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

mkdir -p /var/www/bot/data

3. Configure Environment

Copy and configure the environment file:

cp src/backend/.env.example /var/www/bot/data/.env
nano /var/www/bot/data/.env

Update these values:

• SECRET_KEY - Generate a secure key
• DATABASE_URL - Update path to /var/www/bot/data/app.db
• MINIMAX_API_KEY - Your API key
• AVE_API_KEY - Your API key

4. Build Frontend

cd /var/www/bot/src/frontend
npm install
npm run build

# Move build to expected location
mkdir -p /var/www/bot/frontend
cp -r build/* /var/www/bot/frontend/

5. Configure Nginx

Copy the nginx template and modify as needed:

sudo cp /var/www/bot/deployment/scripts/nginx-template.conf /etc/nginx/sites-available/bot.yourdomain.com
sudo nano /etc/nginx/sites-available/bot.yourdomain.com

Update bot.yourdomain.com with your actual domain.

Enable the site:

sudo ln -s /etc/nginx/sites-available/bot.yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

6. Setup SSL Certificate

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d bot.yourdomain.com

7. Configure Systemd Service

Copy and configure the systemd service:

sudo cp /var/www/bot/deployment/scripts/systemd-template.service /etc/systemd/system/ave-backend.service
sudo nano /etc/systemd/system/ave-backend.service

Update your-user and /var/www/bot paths as needed.

8. Start Backend Service

sudo systemctl daemon-reload
sudo systemctl enable ave-backend
sudo systemctl start ave-backend
sudo systemctl status ave-backend

9. Configure Firewall

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

10. Verify Deployment

1. Visit https://bot.yourdomain.com - should show frontend
2. Visit https://bot.yourdomain.com/api/... - should hit backend API
3. Check backend logs: sudo journalctl -u ave-backend -f

Project Structure

/var/www/bot/
├── deployment/              # Deployment scripts and templates
│   ├── DEPLOYMENT.md       # This file
│   └── scripts/
│       ├── nginx-template.conf
│       ├── systemd-template.service
│       └── deploy.sh       # Automated deployment script
├── src/
│   ├── backend/            # FastAPI application
│   │   ├── app/
│   │   │   ├── api/       # API routes
│   │   │   ├── core/      # Core functionality
│   │   │   ├── db/        # Database models
│   │   │   └── services/  # Business logic
│   │   ├── run.py
│   │   └── requirements.txt
│   └── frontend/           # SvelteKit application
│       ├── src/
│       └── package.json
├── data/                   # Runtime data (gitignored)
│   ├── app.db             # SQLite database
│   └── .env               # Environment variables
└── frontend/              # Built frontend static files

Troubleshooting

Backend won't start

Check logs:

sudo journalctl -u ave-backend -n 100

Common issues:

• Missing environment variables - check .env file
• Port 8000 already in use - check configuration
• Database path incorrect - verify paths

Nginx errors

Test configuration:

sudo nginx -t

Check error logs:

sudo tail -f /var/log/nginx/error.log

SSL certificate issues

Renew certificate:

sudo certbot renew

Check certificate status:

sudo certbot certificates

Useful Commands

Action	Command
Restart backend	sudo systemctl restart ave-backend
View backend logs	sudo journalctl -u ave-backend -f
Check nginx status	sudo systemctl status nginx
Reload nginx	sudo systemctl reload nginx
Check port 8000	curl http://localhost:8000/health

Rolling Updates

To update the application:

cd /var/www/bot
git pull
cd src/backend && source venv/bin/activate && pip install -r requirements.txt
sudo systemctl restart ave-backend

For frontend updates, rebuild and copy static files to /var/www/bot/frontend.