Librebooking¶

⭐ Star us on GitHub — it motivates us a lot!

🔥 Join the community: Discord discussion channel .

Table of Contents¶

About
Features
Demo
Screenshots
Installation & Deployment
Developer Documentation
Configuration & Theming
ReCaptcha
Community & Support
Contributing
Roadmap
License

🚀 About¶

LibreBooking is an open-source resource scheduling solution. It provides a flexible, mobile-friendly, and extensible interface for organizations to manage resource reservations.

The repository for LibreBooking is hosted on GitHub at https://github.com/LibreBooking/librebooking; the develop branch contains the latest code.

LibreBooking is a fork of Booked Scheduler, based on Booked Scheduler’s last open-source version released in 2020. Since then, LibreBooking has evolved significantly and diverged from the original project.

✨ Features¶

[x] Multi-resource booking & waitlists
[x] DataTables for advanced listings
[x] Role-based access control
[x] Quotas and credits for reservations
[x] Granular usage reporting
[x] Responsive Bootstrap 5 interface
[x] Custom themes and color schemes
[x] Plugin-ready architecture
[x] Outlook/Thunderbird integration through ics

🧪 Demo¶

A live demo instance of LibreBooking is available for testing:

Try the demo

Role	Username	Password
Admin	`admin`	`demoadmin`
User	`user`	`demouser`

Note: This instance is public and resets every 20 minutes to ensure a clean environment. Startup might take a few seconds, so please be patient.

📸 Screenshots¶

🔧 Installation & Deployment¶

Manual Installation¶

To run LibreBooking from a prebuilt release, your server needs:

PHP >= 8.2 with the extensions: ctype, curl, fileinfo, json, mbstring, mysqli, openssl, pdo, pdo_mysql, tokenizer, xml
Optional PHP extensions: bcmath (needed for Active Directory authentication), gd (image processing), ldap (LDAP authentication)
A web server like Apache or Nginx
MySQL >= 8.0 (2018) or MariaDB >= 10.6 (2021)
Composer (for managing PHP dependencies)
Git (optional, useful for cloning the repository or managing updates)

For full setup instructions, see INSTALLATION

Docker Deployment¶

LibreBooking is available as a Docker container. See LibreBooking Docker README for complete setup.

git clone https://github.com/LibreBooking/docker.git
cd docker
docker-compose up -d

💻 Developer Documentation¶

See docs/source/README.md for developer notes.
See docs/source/API.rst for API notes.
See docs/source/Oauth2-Configuration.rst for Oauth2 configuration.
See docs/source/SAML-Configuration.rst for SAML configuration.
Codebase follows PSR-12 standards and GitHub Flow.

🎨 Configuration & Theming¶

For configuration options, see the Configuration Guide.

Recent configuration highlights:

Change theme via config.php:
```
'css.theme' = 'default';
```
Theme options: ‘default’, ‘dimgray’, ‘dark_red’, ‘dark_green’, ‘french_blue’, ‘orange’
Customize Web/css/librebooking.css

🔒 ReCaptcha¶

As of 09-Mar-2023, ReCaptcha integration updated to v3. Generate new keys for your domain if using ReCaptcha.

💬 Community & Support¶

🤝 Contributing¶

Fork, file issues, suggest improvements.
Even non-coders can help by reporting bugs, testing, updating issues.
PRs welcome (docs, features, refactoring, fixes).
See CONTRIBUTING.md

💡 Roadmap¶

Work in progress – roadmap to be defined.
Want to suggest a feature? Open an issue or join the Discord discussion channel.

📜 License¶

This project is licensed under GPL-3.0.

🙏 Acknowledgments¶

Forked from Booked Scheduler. Thanks to all contributors and the community.

LibreBooking documentation¶

Table of Contents: