Meet openEduSuite-public: One Clean Home for the Entire Platform
Good news for every institution watching openEduSuite: the platform now has a single, public, ready-to-adopt home.
openEduSuite-public brings together the portal, all 27 deployment variants, the GitOps delivery chain and the full architecture documentation β consolidated, sanitized, and open for you.
The best part: it's built to be yours. Placeholders stay placeholders, secrets stay out of the code, and one command renders the entire platform. Your domains. Your identity provider. Your rules.
A milestone worth celebrating
Today we share a milestone that has been growing quietly in our work for months: everything we know about running openEduSuite in production now lives in one public repository β forkable this afternoon, documented end to end, and free of operator-specific data.
For a long time, our deployment experience lived across several environment-specific adaptation repositories. They served us well β and they taught us everything we needed to build something better. So we did: we consolidated that experience into a single distribution designed from the start to be yours. The environment-specific repositories are superseded by this unified home β and their lessons live on in every line of it.
One repo, everything you need
| Piece | What you get |
|---|---|
| Portal | The configurable service dashboard your users will love: SSO-aware tiles, i18n in de/en/fr/zh, dark mode, weather & news widgets. A static, secure React 19 / Vite SPA on nginx β configured at runtime via /config.json |
| Deployment variants | 27 services as helmfile releases β ILIAS, Moodle, OpenCloud, SOGo, Zammad, JupyterHub and more β with 24 local + 4 vendored Helm charts. The whole platform renders fully offline in one command |
| GitOps, production-style | The exact delivery chain we run in production, made public: an ArgoCD App-of-Apps with one Application per service via the helmfile plugin, plus kubara to bootstrap ArgoCD and the platform layer |
| Documentation | A complete arc42 architecture (12 sections) and C4 models, plus configuration and deployment guides β the same documentation we run on |
| OSS hygiene | Apache-2.0, REUSE/SPDX headers, publiccode.yml, per-component licensing, CI β everything a public-sector institution expects |
What this means for you
- Adoption without baggage. No reverse-engineering someone else's cluster. Start from clean placeholders, fill in your domains, and you're running.
- Sovereignty by design. No operator data lives in the repository β not by promise, but by tests: a portability guard and a leak-check on every render keep it that way. Secrets belong in SOPS, sealed-secrets or external-secrets β never in code.
- Proven, not theoretical. The GitOps wrapper is the same chain our production runs: ArgoCD renders helmfile, helmfile renders charts. If it works for us, it works for you.
- A home with a voice. The "why" behind every decision is public too β arc42 and C4 mean you inherit our thinking, not just our YAML.
Start today
# The portal β about a minute to first paint
docker build -t openedusuite-portal . && docker run -p 8080:80 openedusuite-portal
# The platform β render all 27 services, fully offline
cd helmfile && helmfile -f helmfile.yaml.gotmpl -e example template
# GitOps mode β ArgoCD App-of-Apps, exactly as in production
kubectl apply -f argocd/root-application.yaml
Prefer to read first? Start with the arc42 index, then the deployment variants.
This is only the beginning
A public home grows by the contributions it welcomes. On our near horizon:
- Community-driven improvements to the portal and the app variants β your use cases shape the next iterations
- Broader locale coverage (fr, zh and beyond) and more built-in service tiles
- Continued upstream tracking so the variants and charts keep maturing
- Deeper GitOps guides as the ArgoCD and kubara community grows
Join us β we saved you a seat
openEduSuite is open source under Apache-2.0, and openEduSuite-public is, in a very real sense, yours. We built the home; the community builds what it becomes.
- Try it β fork the repository, replace the placeholders, deploy this week
- Shape it β open an issue or pull request for the portal, a chart, or the docs; every contribution makes the platform better for every institution
- Talk to us β pilot discussions, federation questions and deployment support at info@openedusuite.org
The scattered chapters are consolidated into one open book β this is the good part of the story, and it's only the first page. We're glad you're here.