Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Tymeslot/tymeslot/llms.txt

Use this file to discover all available pages before exploring further.

Tymeslot is an open-source meeting scheduling platform — booking pages, calendar sync, video rooms, webhooks, and automated email — that runs entirely on your own server, under your control. It’s the engine behind tymeslot.app, the managed cloud offering, which means the code you self-host is the exact same codebase running in production for paying customers. New releases ship regularly, and the source stays public and self-hostable under the GNU AGPLv3 — a direct answer to scheduling tools that have closed their source or relicensed away from open source. The source is on GitHub at github.com/Tymeslot/tymeslot.

Pick your deployment path

Docker

Single container with embedded PostgreSQL. The fastest way to get a production instance running on any Linux server — one docker run command and you’re live.

Cloudron

Install via Cloudron’s community package for automatic SSL, one-click updates, built-in backups, and zero server management overhead.

Railway

One-click deploy on Railway’s managed infrastructure. Automatic SSL, built-in PostgreSQL plugin, and no server to maintain.

Managed Cloud

Zero setup. Free plan included; upgrade to Pro for €9/mo. The same codebase, fully managed by the Tymeslot team at Diletta Luna OÜ.

What’s in the box

Everything ships as a single release — no add-ons, no per-feature upsells.

Booking pages

Public scheduling pages with customisable availability rules: working hours, date overrides, holiday blocks, per-meeting buffers, booking windows, and minimum notice periods.

Calendar sync

Bi-directional sync with every connected calendar. Conflicts are checked across all calendars the moment someone books — no double-booking possible.

Video rooms

Auto-create a meeting room when a booking is confirmed. Supports Google Meet, Microsoft Teams, Zoom, MiroTalk P2P, in-person/phone, and custom links.

Webhooks

meeting_created, meeting_cancelled, and meeting_rescheduled events delivered with HMAC signatures. Plug straight into n8n, Zapier, Make, or your own backend.

Embed widget

Inline, popup, or floating-button embeds. Paste one snippet on your site. Tokens are signed and domain-locked so the widget only runs where you put it.

SSO & social login

Email/password, Google, GitHub, plus generic OAuth 2.0/OIDC for Keycloak, Authentik, Okta, Azure AD, and any OIDC-compliant provider. Disable registration or password login independently.

Automated email

Responsive templates, .ics attachments on every send, configurable reminders, and signed cancel/reschedule links that need no login.

Custom questions

Add questions to any meeting type so you walk into every call already briefed — no follow-up messages required.

Payments

Optional paid bookings through Stripe Connect. Off by default — opt in by registering your own Stripe platform. Tymeslot takes no cut unless you set one.

Supported calendars

Tymeslot syncs availability and writes confirmed meetings back — both ways — with every major calendar provider.
ProviderProtocol
Google CalendarGoogle Calendar API
Outlook / Microsoft 365Microsoft Graph API
Apple iCloudCalDAV
NextcloudCalDAV
RadicaleCalDAV
ZimbraCalDAV
BaikalCalDAV
mailbox.orgCalDAV
Any server that speaks standard CalDAV — including self-hosted instances — works out of the box.

Supported video providers

ProviderHow it works
Google MeetAuto-creates a Meet room via API on booking confirmation
Microsoft TeamsAuto-creates a Teams meeting via Microsoft Graph
ZoomAuto-creates a Zoom meeting via Zoom API
MiroTalk P2PGenerates a room link on your own MiroTalk instance
In person / phoneFree-text location field
Custom linkAny static URL you provide

Deployment options

MethodGuideBest for
DockerQuickstart →Any Linux server; embedded PostgreSQL included
CloudronQuickstart →One-click install, automatic updates, zero server ops
RailwayQuickstart →Managed cloud, no server to maintain
Managed Cloudtymeslot.appZero setup, free plan, priority support

Tech stack

Tymeslot is built on a small set of mature, production-proven technologies:
ComponentVersion
Elixir1.20
Erlang/OTP28
Phoenix Framework1.8
Phoenix LiveView1.1
PostgreSQL14+
ObanBackground jobs
Tailwind CSSUI
Swoosh + MJMLEmail delivery
The Elixir/OTP runtime gives Tymeslot low memory usage and fault-tolerant concurrency — the scheduler keeps running even when individual processes crash, and it starts up fast enough to run comfortably on a 500 MB VPS.

Licence

Tymeslot is open source under the GNU AGPLv3. You’re free to use it, self-host it, modify it, and redistribute it. If you run a modified version as a network service, the AGPLv3 requires you to share your changes under the same licence. The licence covers the code. The Tymeslot name and logo are trademarks of Diletta Luna OÜ — forks are welcome but must travel under their own name.

Build docs developers (and LLMs) love