bjoernch / universal_oidc_mail_sso
Universal Roundcube OIDC SSO plugin with IMAP/SMTP mailbox provisioning, policy controls, and encrypted credential storage
Package info
github.com/bjoernch/universal-roundcube-oidc-mail-sso
Type:roundcube-plugin
pkg:composer/bjoernch/universal_oidc_mail_sso
v0.3.1
2026-02-13 12:46 UTC
Requires
- php: >=8.1
- roundcube/plugin-installer: ^0.3.0
README
Universal Roundcube plugin for OIDC SSO + external IMAP/SMTP mailbox provisioning.
This project is designed for users who already host email at a provider with IMAP/SMTP support (Zoho, Fastmail, mailbox.org, etc.) and want a custom-domain webmail frontend (for example https://webmail.example.com) with centralized OIDC login and policy control.
Quick links
- Full docs index: docs/README.md
- Quick start: docs/quickstart.md
- Full configuration reference (all parameters): docs/configuration.md
- Security model: docs/security.md
- Operations and updates: docs/operations.md
Repository layout
plugins/universal_oidc_mail_sso/plugin sourcedocker-compose.ymllocal Roundcube + MariaDB stack.env.exampleenvironment templatedocs/full documentation
Local start (minimal)
cp .env.example .env docker compose up -d docker compose exec -T db mariadb -u"$DB_USER" -p"$DB_PASSWORD" "$DB_NAME" < plugins/universal_oidc_mail_sso/SQL/mysql.local.sql
Roundcube: http://localhost:8080