Skip to main content

Logo Tymeslot

About​

Tymeslot is a self-hosted meeting scheduling platform. Share a booking link, let invitees pick a slot, and have the meeting land on everyone's calendar automatically.

Single sign-on​

The app is installed with Cloudron single sign-on enabled. Users log in with the SSO button on the login page and complete a short registration form on first login.

The first account to log in becomes the administrator.

Administrators​

Additional administrators are promoted from a web terminal:

Bash
/app/bin/tymeslot rpc 'Tymeslot.Release.promote_admin("username@example.com")'

The same command runs from the Cloudron CLI:

Bash
cloudron exec --app tymeslot.example.com -- /app/bin/tymeslot rpc 'Tymeslot.Release.promote_admin("username@example.com")'

Email​

Outgoing mail is relayed through Cloudron's mail server. Confirmation, reminder, reschedule, and cancellation mails are sent without further SMTP configuration.

Set the sender address in the app's Email settings.

Calendar integrations​

Each user connects their own calendars from Dashboard → Integrations. Google Calendar, Microsoft Outlook, and any CalDAV server (Nextcloud, Fastmail, iCloud) are supported. Existing events block availability, and new bookings are written back to the connected calendar.

Google, Microsoft, and Zoom integrations require OAuth credentials from the respective provider. See the Tymeslot documentation for the setup steps.

CalDAV accounts need no extra setup — enter the server URL and credentials in the dashboard.

Data​

App data is stored in the data directory:

  • /app/data/uploads - uploaded images and branding assets
  • /app/data/secret_key_base - session signing secret, generated on first run
  • /app/data/tzdata - timezone database

Bookings, meeting types, and user accounts are stored in PostgreSQL. Both the data directory and the database are part of the app backup.

Booking pages are served from the app's own domain, for example https://tymeslot.example.com/username. Use a secondary domain or alias to shorten the link.