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 >= 5.5
• 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

• Discord
• Wiki
• Issues
• Discussions

🤝 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.

Back to top