Prerequisites
Before deploying RavenmaskOS, ensure your environment meets the following requirements.
Hardware Requirements
Minimum Specifications
| Component | Requirement |
|---|---|
| CPU | 8 cores (ARM64 or x86_64) |
| RAM | 32 GB |
| Storage | 500 GB SSD |
| Network | Gigabit Ethernet |
Recommended Specifications
| Component | Recommendation |
|---|---|
| CPU | Apple Silicon M2/M3 or AMD EPYC |
| RAM | 64 GB or more |
| Storage | 1 TB NVMe SSD |
| Network | 2.5 Gbps Ethernet |
Reference Hardware
The reference deployment runs on:
- odin: Mac Mini M2 Pro (12-core, 32GB RAM, 1TB SSD)
Software Requirements
Operating System
| OS | Version | Notes |
|---|---|---|
| macOS | 14.0+ (Sonoma) | Primary supported platform |
| Ubuntu | 22.04 LTS | Alternative deployment target |
| Debian | 12 (Bookworm) | Alternative deployment target |
Container Runtime
RavenmaskOS uses Docker for container orchestration:
| Component | Version | Notes |
|---|---|---|
| Docker | 24.0+ | Container runtime |
| Colima | 0.6.0+ | macOS Docker runtime (replaces Docker Desktop) |
| Docker Compose | 2.20+ | Multi-container orchestration |
Network Requirements
| Requirement | Details |
|---|---|
| Domain | Valid domain with DNS control (e.g., ravenhelm.dev) |
| SSL/TLS | Let's Encrypt via Traefik (automated) |
| Ports | 80 (HTTP), 443 (HTTPS) exposed to internet |
| DNS Provider | AWS Route53 for DNS-01 challenge |
External Services
Required Services
| Service | Purpose | Notes |
|---|---|---|
| 1Password | Secrets management | CLI access required |
| AWS Route53 | DNS management | For SSL certificate DNS-01 challenges |
Optional Services
| Service | Purpose | Notes |
|---|---|---|
| Anthropic API | Claude AI models | Required for Norns agent |
| OpenAI API | GPT models + embeddings | Fallback for Norns |
| Twilio | SMS/Voice | Optional telephony features |
| Slack | Chat integration | Optional bot deployment |
Network Architecture
Internet
│
▼
┌─────────────┐
│ Traefik │ ← TLS termination, reverse proxy
│ (Port 443) │
└─────────────┘
│
▼
┌─────────────────────────────────────────┐
│ Docker Network │
│ (ravenhelm_net) │
│ │
│ ┌─────────┐ ┌──────────┐ ┌────────┐ │
│ │ Zitadel │ │ Grafana │ │ Norns │ │
│ │ (auth) │ │ (mon) │ │ (ai) │ │
│ └─────────┘ └──────────┘ └────────┘ │
│ │
│ ┌─────────┐ ┌──────────┐ ┌────────┐ │
│ │PostgreSQL│ │ Redis │ │ Ollama │ │
│ │ (data) │ │ (cache) │ │ (llm) │ │
│ └─────────┘ └──────────┘ └────────┘ │
└─────────────────────────────────────────┘
Pre-Installation Checklist
- Hardware meets minimum requirements
- Domain registered and DNS configured
- AWS credentials for Route53 DNS challenges
- Docker/Colima installed and running
- 1Password CLI configured
- SSH access to deployment target
Next Steps
Once prerequisites are met, proceed to Core Stack installation.