Ronni Baslund
69e81757fd
ci / changes (push) Successful in 4s
ci / tc_booking (push) Successful in 21s
ci / tc_portal (push) Successful in 26s
ci / tc_operator (push) Successful in 23s
ci / tc_platform_api (push) Successful in 22s
ci / test_platform_api (push) Successful in 33s
ci / tc_website (push) Successful in 22s
ci / build_booking (push) Successful in 9s
ci / build_zpush (push) Successful in 1m2s
ci / build_portal (push) Successful in 41s
ci / build_operator (push) Successful in 4s
ci / build_platform_api (push) Successful in 4s
ci / deploy (push) Successful in 43s
Stalwart never had ActiveSync built in — that now comes from the zpush gateway. SERVICES.md gains a zpush section with debug commands; website copy (da+en) states what actually works: IMAP everywhere, CalDAV/CardDAV, Exchange accounts in the phone's built-in apps, CalDAV Synchronizer for Outlook on Windows.
116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
# Dezky
|
|
|
|
> Sovereign workspace platform for European businesses.
|
|
> Mail, files, calendar, video meetings — all EU-hosted, all open source.
|
|
|
|
## Quick start (local development)
|
|
|
|
```bash
|
|
# 1. Clone and enter
|
|
git clone <repo-url> dezky
|
|
cd dezky
|
|
|
|
# 2. Run bootstrap (handles everything)
|
|
./scripts/bootstrap.sh
|
|
|
|
# 3. Open the portal
|
|
open https://app.dezky.local
|
|
```
|
|
|
|
The bootstrap script:
|
|
- Checks prerequisites (Docker, mkcert, openssl)
|
|
- Generates wildcard TLS certificate via mkcert
|
|
- Adds /etc/hosts entries (with your permission)
|
|
- Generates secure random secrets in `.env`
|
|
- Pulls Docker images
|
|
- Starts all services in correct order
|
|
- Prints next-step instructions
|
|
|
|
## Service URLs (local development)
|
|
|
|
| Service | URL | Purpose |
|
|
|---------|-----|---------|
|
|
| Portal | https://app.dezky.local | Customer-facing landing & launcher |
|
|
| Authentik | https://auth.dezky.local | Identity provider (OIDC/SAML) |
|
|
| Files (OCIS) | https://files.dezky.local | File storage & sharing |
|
|
| Mail (Stalwart) | https://mail.dezky.local | Mail server admin UI |
|
|
| Office | https://office.dezky.local | Collabora Online editor |
|
|
| Traefik | https://traefik.dezky.local | Reverse proxy dashboard |
|
|
|
|
## What's in this repo
|
|
|
|
```
|
|
dezky/
|
|
├── apps/portal/ Nuxt 3 customer portal
|
|
├── services/platform-api/ NestJS service · tenants, partners, users, provisioning orchestration
|
|
├── packages/ Shared TypeScript libraries
|
|
├── infrastructure/
|
|
│ └── docker-compose/ Local development stack
|
|
├── scripts/ Setup, reset, helpers
|
|
└── docs/ Service references & guides
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
- macOS or Linux (Windows users: use WSL2)
|
|
- Docker Desktop 24+ or OrbStack
|
|
- mkcert (`brew install mkcert`)
|
|
- pnpm 9+ (`brew install pnpm`)
|
|
- Node.js 20+
|
|
- 16 GB RAM recommended
|
|
|
|
## Common commands
|
|
|
|
```bash
|
|
# Start everything
|
|
docker compose -f infrastructure/docker-compose/docker-compose.yml up -d
|
|
|
|
# View logs
|
|
docker compose -f infrastructure/docker-compose/docker-compose.yml logs -f [service]
|
|
|
|
# Stop everything (keeps data)
|
|
docker compose -f infrastructure/docker-compose/docker-compose.yml down
|
|
|
|
# Nuke and restart (DESTROYS DATA)
|
|
./scripts/reset.sh
|
|
```
|
|
|
|
## Architecture
|
|
|
|
This is a multi-tenant SaaS platform. Each tenant gets:
|
|
- Isolated Authentik OIDC tenant
|
|
- Custom subdomain (e.g. `customer-name.dezky.local`)
|
|
- Mail domain in Stalwart with auto-generated DKIM
|
|
- Dedicated OCIS space hierarchy
|
|
- Branded launcher in the portal
|
|
|
|
All components are Apache 2.0 / MIT licensed — no per-seat fees, full whitelabel rights.
|
|
|
|
## Production
|
|
|
|
The production target is a single Hetzner AX41-NVMe server (€39/mo) with:
|
|
- Stalwart on bare-metal
|
|
- k3s for all other services
|
|
- Hetzner Object Storage (€5/mo) as OCIS S3 backend
|
|
- Storage Box BX11 (€3.20/mo) for Restic backups
|
|
- Storage Box BX11 in Helsinki (€3.20/mo) for DR
|
|
|
|
See `docs/PRODUCTION-DEPLOYMENT.md` (TBD) for migration plan.
|
|
|
|
## Stack rationale
|
|
|
|
These choices are deliberate after extensive license/architecture research. See `CLAUDE.md` for the full reasoning.
|
|
|
|
| Component | License | Why this one |
|
|
|-----------|---------|--------------|
|
|
| Stalwart Mail | Apache 2.0 | Modern Rust, JMAP support (EAS via Z-Push gateway) |
|
|
| OCIS | Apache 2.0 | Cleaner license than Nextcloud (AGPL+trademark) |
|
|
| Zulip | Apache 2.0 | Only truly open-core-free chat option |
|
|
| Authentik | MIT | Better multi-tenancy than Keycloak |
|
|
| Hetzner | N/A | 100% EU sovereignty — core to business |
|
|
|
|
## License
|
|
|
|
Application code: MIT (own code)
|
|
Third-party services: see individual service licenses in stack.
|