Skip to content

developeregrem/fewohbee

Repository files navigation

guesthouse and hotel management software FewohBee

For german version see: README.de.md

The hotel management software for small to medium-sized pensions and hotels - open source and free of charge.

The guesthouse management tool or property managment system (PMS) is a PHP project based on the amazing PHP framework Symfony. Small guesthouses or accommodations usually manage their rooms or apartments the old way by using a pen and a sheet of paper or using a spreadsheet. The goal of this open-source tool is to help smaller accommodations to replace the hand written approach to manage rooms, to improve productivity by combining all information which, finally, ends in a time reduction to manage the guesthouse.

For a detailed documentation please refer to the Wiki.

Features

  • easy way to add and manage reservations (reservation overview)
  • manage your guest data (including a GDPR export function)
  • extensive settings to manage your
    • rooms, accommodations, prices, reservation origins, templates, etc.
  • create invoices (PDF)
  • conversations (write mails from within the tool), send invoices, reservation confirmations or other relevant information to the guest
  • statistics
  • registration book
  • cash book to manage your income and outcome
  • calendar export for other applications (iCal sync)

Requirements

In order to use the tool, you need to have a small web server fulfilling the Symfony requirements. This means:

  • PHP 8.1 or higher
  • php-intl extension installed and activated
  • a web server e.g. nginx or apache
  • a database server (recommended is mysql or mariadb)

Quick Start

It's recommended to use the docker-compose setup: fewohbee-dockerized

Create a database for the tool:

CREATE DATABASE fewohbee CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Copy the file .env.dist and name the new file .env.

Edit the file .env and update the property DATABASE_URL to meet your database settings. Generate a random value and update the property APP_SECRET (you can use the following site to generate a random value: Link)

If not already available download the PHP dependency manager composer in order to install project dependencies. Afterwards run the following command within the root folder of the project:

composer install

Run the following command to initialize the database and the application:

php bin/console doctrine:migration:migrate
php bin/console app:first-run

// optional: add some test data
php bin/console doctrine:fixtures:load --append

Now, you are ready to open a browser, navigate to the installation folder e.g. http://localhost/fewohbee/public/index.php and login with the user created in the step before.

Using Docker

To run the application using docker a pre-configured docker-compose setup is available. Please refer to the documentation in the Wiki: Docker-Setup

i18n

The tool has multi language support by design and is available in german and english. If you have a language request to support other languages, please open a ticket.

Author

Alexander Elchlepp

This project is a one man show at the moment and developed in my free time since 2014. If you have questions open a ticket or contact me at info (at) fewohbee.de

If you want to support this project and you think the project is useful for you I would be very happy about a small donation :) Donate