xynap Documentation¶
Welcome to the internal documentation of xynap Platform.
What is xynap?¶
xynap is an integrated hosting and AI plating form that runs on a Hetzner Bare-Metal server. It combines:
- Hosting Management— Domains, DNS, Web hosting, E-mail, SSL
- AI Stack— Open WebUI, Ollama, Whisper STT, Piper TTS, LibreTranslate
- Kommunikation— FreeSwitch PBX, SIP/WebRTC, Telegram/WhatsApp Bridges
- Infrastructure— KVM/libvirt VMs, Docker Stack (~25 containers), Traefik Reverse Proxy
Quick handle¶
| Area | Description |
|---|---|
| Architecture | Server installation, network, container |
| Platform API | REST API with 317 endpoints |
| Services | Traefik, FreeSwitch, AI, Monitoring |
| Operating | Deployment, Backup, Security |
Technology stack¶
| Component | Technology |
|---|---|
| Backend | FastAPI + SQLAlchemy 2.0 async + MariaDB 11.4 |
| Frontend | Vue 3.5 + TypeScript + Vite + Tailwind CSS 4 |
| Auth | JWT + TOTP 2FA + OAuth2 (GitHub/Google) + Telegram 2FA |
| Reverse proxy | Traefik v3.0 + Let's Encrypt + CrowdSec |
| AI | Ollama (RTX 4000 Ada 20GB), Whisper, Piper TTS |
| PBX | FreeSwitch + mod xml curl + WebRTC |
| Postfix + Dovecot + Rspamd + Roundcube |
Hardware¶
Server:nexus.isn-systems.com(Hetzner Dedicated)
- Intel i5-13500 (20 threads)
- 62 GB RAM
- NVIDIA RTX 4000 Ada (20 GB VRAM)
- 1.7 TB Disk
- IP:
46.4.96.105