Algvex Website Management
Web interface for AlgVex trading system at algvex.com.
Architecture
Caddy (HTTPS)
algvex.com:443
│
┌───────────┴───────────┐
│ │
Frontend Backend
(Next.js) (FastAPI)
localhost:3000 localhost:8000
Key Information
Item Value
Domain algvex.com
Server 139.180.157.152
Frontend Next.js 14 + TypeScript
Backend FastAPI + Python 3.12
Database SQLite
Auth Google OAuth
Install Path /home/linuxuser/algvex
Directory Structure
/home/linuxuser/algvex/ ├── backend/ # FastAPI backend │ ├── main.py │ ├── .env # Configuration │ └── algvex.db # SQLite database ├── frontend/ # Next.js frontend │ ├── .next/ # Build output │ └── pages/ # Page components └── deploy/ # Deployment configs
Deployment Commands
Full Deployment
cd /home/linuxuser/nautilus_AlgVex/web/deploy chmod +x setup.sh ./setup.sh
Restart Services
sudo systemctl restart algvex-backend algvex-frontend caddy
Check Status
sudo systemctl status algvex-backend sudo systemctl status algvex-frontend sudo systemctl status caddy
View Logs
Backend logs
sudo journalctl -u algvex-backend -f
Frontend logs
sudo journalctl -u algvex-frontend -f
Caddy logs
sudo journalctl -u caddy -f
Configuration
Backend Environment (/home/linuxuser/algvex/backend/.env)
Required
SECRET_KEY=your-secure-key GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret ADMIN_EMAILS=your-email@gmail.com
AlgVex Integration
ALGVEX_PATH=/home/linuxuser/nautilus_AlgVex ALGVEX_CONFIG_PATH=/home/linuxuser/nautilus_AlgVex/configs/base.yaml ALGVEX_SERVICE_NAME=nautilus-trader
Google OAuth Setup
-
Create OAuth 2.0 Client ID
-
Add redirect URI: https://algvex.com/api/auth/callback/google
-
Copy credentials to .env
API Endpoints
Public (No Auth)
Endpoint Description
/api/public/performance
Trading stats
/api/public/social-links
Social links
/api/public/copy-trading
Copy trading links
/api/public/system-status
Bot status
Admin (Auth Required)
Endpoint Description
/api/admin/config
Strategy config
/api/admin/service/control
Service control
/api/admin/social-links/*
Manage links
Caddy Configuration
Located at /etc/caddy/Caddyfile :
algvex.com { handle /api/* { reverse_proxy localhost:8000 } handle { reverse_proxy localhost:3000 } }
Common Issues
Issue Solution
HTTPS not working Check DNS, wait for Let's Encrypt
502 Bad Gateway Restart backend/frontend services
OAuth callback error Verify redirect URI in Google Console
Config not updating Restart algvex-backend
Key Files
File Purpose
web/backend/main.py
Backend entry point
web/frontend/pages/index.tsx
Homepage
web/frontend/pages/admin/index.tsx
Admin panel
web/deploy/Caddyfile
Reverse proxy config
web/deploy/setup.sh
Deployment script