mirror of
https://codeberg.org/likwid/likwid.git
synced 2026-02-09 21:13:09 +00:00
Marco Allegretti
910a6465f2
- Backend: Rust/Axum with PostgreSQL, plugin architecture - Frontend: Astro with polished UI - Voting methods: Approval, Ranked Choice, Schulze, STAR, Quadratic - Features: Liquid delegation, transparent moderation, structured deliberation - Documentation: User and admin guides in /docs - Deployment: Docker/Podman compose files for production and demo - Demo: Seeded data with 3 communities, 13 users, 7 proposals License: AGPLv3
124 lines
2.4 KiB
Markdown
124 lines
2.4 KiB
Markdown
# Installation Guide
|
|
|
|
This guide covers deploying Likwid for production use.
|
|
|
|
## Requirements
|
|
|
|
- **PostgreSQL 16+**
|
|
- **Rust 1.75+** (for building backend)
|
|
- **Node.js 20+** (for building frontend)
|
|
- **Container runtime** (Podman or Docker) - optional but recommended
|
|
|
|
## Quick Start with Containers
|
|
|
|
### 1. Clone the Repository
|
|
|
|
```bash
|
|
git clone https://codeberg.org/likwid/likwid.git
|
|
cd likwid
|
|
```
|
|
|
|
### 2. Configure Environment
|
|
|
|
```bash
|
|
cp compose/.env.production.example compose/.env.production
|
|
# Edit .env.production with your settings
|
|
```
|
|
|
|
Required settings:
|
|
- `POSTGRES_PASSWORD` - Strong database password
|
|
- `JWT_SECRET` - Random 64+ character string
|
|
|
|
### 3. Deploy
|
|
|
|
```bash
|
|
cd compose
|
|
podman-compose --env-file .env.production -f production.yml up -d
|
|
```
|
|
|
|
### 4. Access
|
|
|
|
- Frontend: http://localhost:4321
|
|
- Backend API: http://localhost:3000
|
|
|
|
## Manual Installation
|
|
|
|
### Backend
|
|
|
|
```bash
|
|
cd backend
|
|
|
|
# Install dependencies and build
|
|
cargo build --release
|
|
|
|
# Run migrations
|
|
export DATABASE_URL="postgres://user:pass@localhost/likwid"
|
|
sqlx migrate run
|
|
|
|
# Start server
|
|
./target/release/likwid
|
|
```
|
|
|
|
### Frontend
|
|
|
|
```bash
|
|
cd frontend
|
|
|
|
# Install dependencies
|
|
npm ci
|
|
|
|
# Build for production
|
|
npm run build
|
|
|
|
# Start server
|
|
node ./dist/server/entry.mjs
|
|
```
|
|
|
|
## Configuration Files
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `compose/production.yml` | Production container deployment |
|
|
| `compose/demo.yml` | Demo instance deployment |
|
|
| `compose/.env.production.example` | Environment template |
|
|
| `backend/.env` | Backend configuration |
|
|
|
|
## Reverse Proxy
|
|
|
|
For production, use a reverse proxy (nginx, Caddy) with:
|
|
- HTTPS termination
|
|
- WebSocket support (for real-time features)
|
|
- Proper headers
|
|
|
|
Example nginx config:
|
|
|
|
```nginx
|
|
server {
|
|
listen 443 ssl http2;
|
|
server_name likwid.example.org;
|
|
|
|
ssl_certificate /path/to/cert.pem;
|
|
ssl_certificate_key /path/to/key.pem;
|
|
|
|
location / {
|
|
proxy_pass http://127.0.0.1:4321;
|
|
proxy_http_version 1.1;
|
|
proxy_set_header Upgrade $http_upgrade;
|
|
proxy_set_header Connection "upgrade";
|
|
proxy_set_header Host $host;
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|
}
|
|
|
|
location /api {
|
|
proxy_pass http://127.0.0.1:3000;
|
|
proxy_set_header Host $host;
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|
}
|
|
}
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
- [Configuration](configuration.md) - Detailed settings
|
|
- [Database](database.md) - Database management
|
|
- [Security](security.md) - Hardening your instance
|