How ghassenbz/vikunja works
This repository provisions a private-network AWS deployment of Vikunja, rather than implementing the Vikunja application itself. The user-facing path is browser → public ALB → static frontend, with API, DAV, and CalDAV requests routed to backend instances; Vikunja uses private RDS for application data and a dedicated S3 bucket for uploads. Terraform modules define the infrastructure, while a first-boot seed populates demo accounts and workspaces through the Vikunja API. The README documents these runtime relationships; Terraform source was not sampled, so edges rely on that documentation.
Main entry points: compute/main.tf Vikunja backend · infra/main.tf Terraform root · network/main.tf Application load balancer · backup-data.ps1 Backup helper
Components 17
Ingress and application
- Application load balancer
infra/modules/network/main.tf - Frontend instances
infra/modules/compute/main.tf - Vikunja backend
infra/modules/compute/main.tf - Vikunja server
Compute and bootstrap
- Release and runtime bucket
infra/modules/compute/main.tf - Lab instance profile
infra/modules/compute/main.tf - Demo data seeder
vikunja/seed-demo.py
Persistence
- MySQL database
infra/modules/database/main.tf - Vikunja uploads bucket
infra/modules/database/main.tf - Backup helper
scripts/backup-data.ps1
Infrastructure definition
- VPC and subnets
infra/modules/network/main.tf - Security groups
infra/modules/security/main.tf - Compute configuration
infra/modules/compute/main.tf - Database configuration
infra/modules/database/main.tf - Terraform root
infra/main.tf
Other components
- Browser user
- AWS services
Connections 21
- Browser user → Application load balancer: opens app
README.md - Application load balancer → Frontend instances: serves default
README.md - Application load balancer → Vikunja backend: routes API and DAV
README.md - Frontend instances → Browser user: serves static UI
README.md - Vikunja backend → Vikunja server: runs API
README.md - Vikunja backend → MySQL database: stores app data
README.md - Vikunja backend → Vikunja uploads bucket: stores uploads
README.md - Frontend instances → Release and runtime bucket: downloads bundle and config
README.md - Vikunja backend → Release and runtime bucket: downloads bundle and config
README.md - Lab instance profile → Release and runtime bucket: grants object access
README.md - Demo data seeder → Vikunja server: seeds through API
README.md - Backup helper → MySQL database: snapshots database
README.md - Backup helper → Vikunja uploads bucket: copies upload data
README.md - Terraform root → VPC and subnets: configures
README.md - Terraform root → Security groups: configures
README.md - Terraform root → Compute configuration: configures
README.md - Terraform root → Database configuration: configures
README.md - VPC and subnets → AWS services: provisions network
README.md - Security groups → AWS services: provisions controls
README.md - Compute configuration → AWS services: provisions compute
README.md - Database configuration → AWS services: provisions storage
README.md