2.7 KiB
2.7 KiB
Chapter 19: Maintenance and Updates
botserver includes a complete stack of self-hosted services that power your bots. This chapter covers how to maintain, update, and troubleshoot these components.
Stack Components Overview
botserver automatically installs and manages these services:
| Component | Service | Default Port | Purpose |
|---|---|---|---|
| vault | HashiCorp Vault | 8200 | Secrets management |
| tables | PostgreSQL | 5432 | Primary database |
| directory | Zitadel | 8080 | Identity & access management |
| drive | MinIO | 9000, 9001 | Object storage (S3-compatible) |
| cache | Valkey | 6379 | In-memory cache (Redis-compatible) |
| llm | llama.cpp | 8081, 8082 | Local LLM & embedding server |
| Stalwart | 25, 993 | Mail server | |
| proxy | Caddy | 443, 80 | HTTPS reverse proxy |
| dns | CoreDNS | 53 | Local DNS resolution |
| alm | Forgejo | 3000 | Git repository (ALM) |
| alm_ci | Forgejo Runner | - | CI/CD runner |
| meeting | LiveKit | 7880 | Video conferencing |
Directory Structure
botserver-stack/
├── bin/ # Service binaries
│ ├── vault/
│ ├── tables/
│ ├── drive/
│ ├── cache/
│ ├── llm/
│ └── ...
├── conf/ # Configuration files
├── data/ # Persistent data
└── logs/ # Service logs
botserver-installers/ # Downloaded archives (cache)
Why Self-Hosted?
- Privacy - Data never leaves your infrastructure
- Offline - Works without internet after initial setup
- Cost - No per-user or API fees
- Control - Full access to all services
- Compliance - Meet data residency requirements
Chapter Contents
- CLI Reference - Command-line interface for botserver
- Updating Components - How to update individual services
- Component Reference - Detailed info for each component
- Security Auditing - Running security audits
- Backup and Recovery - Data protection strategies
- Troubleshooting - Common issues and solutions
Quick Commands
# Check service status
./botserver status
# View logs
tail -f botserver-stack/logs/llm.log
# Restart all services
./botserver restart
# Update a specific component
./botserver update llm
Related Documentation
- Installation - Initial setup
- Secrets Management - Vault configuration
- LLM Configuration - AI model settings