Funkapparat

Funkapparat is a Danish term for radio set.

Part of the Apparat Suite ⚙️ This tool is part of a decoupled set of single-purpose event management tools built for demoparties. ➔ Read more about the full Apparat suite here

It is a editor for news and announcements at demoparties. Can be used in conjunction with billedapparat.

Tooling

• Backend
  • Go
  • Gin Web Framework
  • GORM
  • Cobra & Viper
• Frontend
  • React
  • Vite
  • React Admin
• Database
  • SQLite
• Identity & Local Infrastructure
  • Dex (OIDC Provider)
  • Traefik (Local Edge Router)
  • mkcert & dnsmasq (Local TLS & .test Routing)
• Observability
  • Sentry
  • OpenTelemetry
• Development & Ops
  • mise
  • Docker

Quickstart

We use mise to automatically manage all tool versions (Go, Node, etc.) and project tasks.

# 1. Install mise (if not already installed)
curl https://mise.run | sh

# 2. Setup local infrastructure
# This generates local certificates, configures dnsmasq/resolver, and updates /etc/hosts (Linux)
mise run infra:prepare

# 3. Start local services (Traefik, Dex, etc.)
mise run infra:up

# 4. Start the development server (hot-reload for backend & frontend)
overmind s --timeout 10

Local Environment

Once the stack is running, you can access the applications via:

• Funkapparat Admin: https://funkapparat.test

Documentation

Please refer to the documentation on

• configuration
• redis sync
• authentication
• setting up a global traefik service

Further information will be added soon.