Follow these instructions to set up a local development environment.

• Rust: Install via rustup.
• Node.js & npm: For the frontend.
• SQLite3: For the database.
• Certbot: (Optional) Required for testing SSL generation locally.

• /backend: Rust source code.
• /frontend: React source code.
• /data: Default directory for database and certificates (ignored by git).

1. Navigate to the backend directory:

   cd backend

2. Create a .env file (optional, defaults are used):

   JWT_SECRET=dev_secret
   RUST_LOG=debug

3. Run the backend:

   cargo run

   The backend will listen on:
   • 0.0.0.0:81 for API/Dashboard.
   • 0.0.0.0:8080 for HTTP Proxy.

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Access the dashboard at http://localhost:5173. The Vite dev server is configured to proxy /api requests to localhost:81.

cd backend
cargo test

docker compose -f docker-compose.dev.yml up --build

• Database: You can use any SQLite browser to inspect data/data.db.
• Logs: Backend logs are printed to stdout and also saved in logs/.
• Pingora: Note that Pingora might require specific permissions to bind to low ports (like 443). For local dev, we use 8080.

Next: API Documentation