Files

Sylvain Zimmer 9c18f96090 ✨(all) add organizations, resources, channels, and infra migration (#34 )

Add multi-tenant organization model populated from OIDC claims with
org-scoped user discovery, CalDAV principal filtering, and cross-org
isolation at the SabreDAV layer.

Add bookable resource principals (rooms, equipment) with CalDAV
auto-scheduling that handles conflict detection, auto-accept/decline,
and org-scoped booking enforcement. Fixes #14.

Replace CalendarSubscriptionToken with a unified Channel model
supporting CalDAV integration tokens and iCal feed URLs, with
encrypted token storage and role-based access control. Fixes #16.

Migrate task queue from Celery to Dramatiq with async ICS import,
progress tracking, and task status polling endpoint.

Replace nginx with Caddy for both the reverse proxy and frontend
static serving. Switch frontend package manager from yarn/pnpm to
npm and upgrade Node to 24, Next.js to 16, TypeScript to 5.9.

Harden security with fail-closed entitlements, RSVP rate limiting
and token expiry, CalDAV proxy path validation blocking internal
API routes, channel path scope enforcement, and ETag-based
conflict prevention.

Add frontend pages for resource management and integration channel
CRUD, with resource booking in the event modal.

Restructure CalDAV paths to /calendars/users/ and
/calendars/resources/ with nested principal collections in SabreDAV.

2026-03-09 09:09:34 +01:00

4.4 KiB

Raw Blame History

Chat on Matrix - Documentation - Getting started - Reach out

Calendars

A modern, open-source calendar application for managing events and schedules.

Why use Calendars ❓

Calendars empowers teams to manage events and schedules while maintaining full control over their data through a user-friendly, open-source platform.

Manage Events

📅 Create and manage events and schedules
🌐 Access your calendar from anywhere with our web-based interface

Organize

📂 Organized calendar structure with intuitive navigation

Collaborate

🤝 Share calendars with your team members
👥 Granular access control to ensure your information is secure and only shared with the right people
🏢 Create workspaces to organize team collaboration

Self-host

🚀 Easy to install, scalable and secure calendar solution

Getting started 🔧

Prerequisite

Make sure you have a recent version of Docker and Docker Compose installed on your laptop:

$ docker -v
  Docker version 27.x

$ docker compose version
  Docker Compose version v2.x

⚠️ You may need to run the following commands with sudo but this can be avoided by assigning your user to the docker group.

Bootstrap project

The easiest way to start working on the project is to use GNU Make:

$ make bootstrap

This command builds the containers, installs dependencies, and runs database migrations. It's a good idea to use this command each time you are pulling code from the project repository to avoid dependency-related or migration-related issues.

Your Docker services should now be up and running! 🎉

You can access the project by going to http://localhost:8930.

You will be prompted to log in. The default credentials are:

username: calendars
password: calendars

Note that if you need to run them afterward, you can use the eponym Make rule:

$ make start

You can check all available Make rules using:

$ make help

⚠️ For frontend developers, it is often better to run the frontend in development mode locally.

First, install the frontend dependencies:

$ make install-front

Then start the backend services:

$ make start-back

And run the frontend locally in development mode:

$ cd src/frontend/apps/calendars && npm run dev

Django admin

You can access the Django admin site at http://localhost:8931/admin.

You first need to create a superuser account:

$ make superuser

You can then login with sub admin@example.com and password admin.

Feedback 🙋‍♂️🙋‍♀️

We'd love to hear your thoughts and hear about your experiments, so come and say hi on Matrix.

Contributing 🙌

This project is intended to be community-driven, so please, do not hesitate to get in touch if you have any question related to our implementation or design decisions.

License 📝

This work is released under the MIT License (see LICENSE).

While Calendars is a public driven initiative our licence choice is an invitation for private sector actors to use, sell and contribute to the project.

Credits ❤️

Calendars is built on top of Django REST Framework, Next.js and SabreDAV. We thank the contributors of all these projects for their awesome work!

4.4 KiB Raw Blame History