98 lines
2.8 KiB
Markdown
98 lines
2.8 KiB
Markdown
# Fluxer Chat Server Setup
|
|
|
|
## Overview
|
|
|
|
Fluxer is a modern, Discord-like messaging platform deployed on st.vish.gg, replacing the previous Stoat Chat installation. It runs as a unified server container on the Seattle VM.
|
|
|
|
## Quick Reference
|
|
|
|
| Property | Value |
|
|
|----------|-------|
|
|
| **Domain** | st.vish.gg |
|
|
| **Host** | Seattle VM (YOUR_WAN_IP) |
|
|
| **Repository** | https://github.com/fluxerapp/fluxer |
|
|
| **Branch** | `refactor` |
|
|
| **Local Path** | `/root/fluxer` |
|
|
| **Compose Files** | `compose.yaml` + `compose.override.yaml` |
|
|
| **Nginx Config** | `/etc/nginx/sites-available/fluxer` |
|
|
| **SSL Cert** | `/etc/nginx/ssl/st.vish.gg.{crt,key}` (wildcard, expires May 2026) |
|
|
|
|
## Architecture
|
|
|
|
### Unified Server Model
|
|
Fluxer runs as a single `fluxer-server` container that bundles:
|
|
- Frontend app, REST API, WebSocket gateway, admin panel, media proxy, and S3 storage
|
|
|
|
### Supporting Services
|
|
| Service | Purpose | Image |
|
|
|---------|---------|-------|
|
|
| valkey | Cache/sessions (Redis-compatible) | `valkey/valkey:8.0.6-alpine` |
|
|
| meilisearch | Full-text search | `getmeili/meilisearch:v1.14` |
|
|
| elasticsearch | Alternative search | `elasticsearch:8.19.11` |
|
|
| livekit | Voice/video calls | `livekit/livekit-server:v1.9.11` |
|
|
| nats-core | Message broker | `nats:2-alpine` |
|
|
| nats-jetstream | Persistent streaming | `nats:2-alpine` |
|
|
|
|
### Network Configuration
|
|
- **Fluxer server**: `127.0.0.1:8088` (only accessible via nginx)
|
|
- **Nginx**: Ports 80/443 on the host, terminates SSL
|
|
- **Subdomains**: `api`, `events`, `files`, `proxy`, `voice` — all routed to fluxer_server on different path prefixes
|
|
|
|
## Initial Setup
|
|
|
|
### 1. Clone Repository
|
|
```bash
|
|
cd /root
|
|
git clone https://github.com/fluxerapp/fluxer.git
|
|
cd fluxer
|
|
git checkout refactor
|
|
```
|
|
|
|
### 2. Configure
|
|
```bash
|
|
# Edit the application config
|
|
vim config/config.json
|
|
|
|
# Set base domain, S3 credentials, etc.
|
|
```
|
|
|
|
### 3. Build and Deploy
|
|
```bash
|
|
MEILI_MASTER_KEY=<your-key> docker compose build fluxer_server
|
|
MEILI_MASTER_KEY=<your-key> docker compose up -d
|
|
```
|
|
|
|
### 4. Verify
|
|
```bash
|
|
curl -fsS http://127.0.0.1:8088/_health
|
|
# Should return JSON with all services healthy
|
|
```
|
|
|
|
## Health Check
|
|
|
|
The `/_health` endpoint returns status for all internal services:
|
|
```json
|
|
{
|
|
"status": "healthy",
|
|
"services": {
|
|
"kv": {"status": "healthy"},
|
|
"s3": {"status": "healthy"},
|
|
"jetstream": {"status": "healthy"},
|
|
"mediaProxy": {"status": "healthy"},
|
|
"admin": {"status": "healthy"},
|
|
"api": {"status": "healthy"},
|
|
"app": {"status": "healthy"}
|
|
}
|
|
}
|
|
```
|
|
|
|
## See Also
|
|
|
|
- [Fluxer Deployment Details](fluxer-deployment.md) — full deployment history, maintenance commands, and changelog
|
|
- [Fluxer Migration Guide](fluxer-migration-guide.md) — migration from Stoat Chat (February 2026)
|
|
|
|
---
|
|
|
|
**Last Updated**: April 7, 2026
|
|
**Status**: Production Running
|