Setup Hotel Management

• Get the newest version of Hotel Management from your vendor, partner, or download link (for example a ZIP file from Webby or your Odoo integrator).
• Save the file on your computer and unzip it if it is compressed.
• After unzipping, you should see a folder named webby_hotel_management_odoo. That entire folder is the addon – do not rename it unless your administrator tells you to.
• Check that the folder contains files such as __manifest__.py and subfolders like models, views, and security. If those are missing, the download may be incomplete – download again.

• Connect to the computer or server where Odoo is installed (using remote desktop, SSH, or ask your hosting provider).
• Find your Odoo addons path. Common locations are:
  • custom_addons – recommended for third-party apps like this one
  • addons – the standard Odoo addons directory

  Your administrator can confirm the correct path in the Odoo configuration file (odoo.conf) under addons_path.

• Copy the entire webby_hotel_management_odoo folder into that directory. Example result: custom_addons/webby_hotel_management_odoo/
• Make sure the Odoo system user (the account that runs Odoo) can read the new folder and its files.

• Odoo only scans for new addons when it starts. After copying the folder, you must restart the Odoo service.
• On Windows: restart the Odoo service from Services, or stop and start your Odoo batch file.
• On Linux: run a command such as sudo systemctl restart odoo (exact command depends on your server setup).
• On Odoo.sh or managed hosting: follow your provider’s steps to deploy the new code and restart the instance.
• Wait until Odoo is fully running again before continuing. You should be able to open Odoo in your browser as usual.

• Log in to Odoo as an Administrator.
• Open Settings (gear icon in the main app menu).
• Scroll to the bottom of the General Settings page. Click Activate the developer mode (or Developer Tools → Activate the developer mode).
• You may also activate it by adding ?debug=1 to the end of your Odoo URL in the browser address bar and pressing Enter – then refresh the page.
• Developer mode unlocks technical options you need next, such as Update Apps List. It does not change how normal hotel staff work day to day.

• Open the Apps menu from the Odoo home screen.
• Click the ⋮ (three dots) menu or look for Update Apps List at the top. This option only appears when Developer Mode is on.
• Click Update Apps List and confirm when Odoo asks. This tells Odoo to scan all addon folders again and register new applications.
• Wait for the process to finish. You may see a short loading message.
• Remove the Apps filter if it is active (click the × on the “Apps” search chip) so you can search all modules.

• In Apps, use the search bar and type Hotel Management.
• You should see an app card titled Hotel Management by Webby, category Services/Hotel.
• Click Activate (or Install). Odoo will install the app and everything it depends on (Contacts, Accounting, HR, Attendance, and so on).
• Wait until installation completes. This can take one to several minutes depending on your server.
• When finished, Odoo may redirect you or show the app as Installed. You should now see a Hotel entry in your main app menu.

• Hotel Management includes demo data – a sample property, rooms, bookings, rate plans, and more – so you can explore the system before entering your real data.
• When demo loads automatically: If your Odoo database was created with Load demonstration data checked, demo records are installed together with the app. You will see sample hotels and bookings right away.
• When demo does not load: On a production database created without demo data, installing the app will not add sample records. That is normal. You will configure your own property in Configure Your Property.
• To check if demo data is present: open Hotel → Configuration → Properties. If you see a sample hotel (for example a demo grand hotel), demo data was loaded.
• Demo data is for learning and testing only. Remove or replace it before going live with real guest information.

• Installing the app does not automatically give every user access. You must assign hotel permissions to each person who needs the Hotel menu.
• Go to Settings → Users & Companies → Users (or Settings → Users).
• Open the user you want to give access to (for example a front-desk agent or yourself).
• Click the Access Rights tab (you may need Developer Mode to see all groups clearly).
• Find the section named Hotel and choose one option:
  • User – for reservation agents, front desk, housekeeping coordinators. Can use bookings, front desk, housekeeping, maintenance, and basic folios.
  • Manager – for supervisors and revenue managers. Includes everything User has, plus Configuration, invoices, deposits, and staff attendance management.
• Click Save on the user form.
• Repeat for every team member who needs access. Users without a Hotel role will not see the Hotel app at all.

• After saving user permissions, the affected user should log out and log back in, or press Ctrl + F5 (hard refresh) in the browser.
• On the Odoo home screen (app dashboard), look for the Hotel application icon or name in the main menu bar.
• Click Hotel. You should see menus such as Reservations, Front Desk, Guests, Housekeeping, Finance, and Reporting.
• If you assigned Manager, you should also see Configuration under Hotel.
• If the menu still does not appear: double-check that the user has Hotel User or Hotel Manager ticked, that the app shows as Installed in Apps, and that you are logged in as that user (not a different account).
• Success! Continue to Getting Started to learn each menu, then set up your property.

The physical folder on the server. Odoo reads the app name and version from the file inside called __manifest__.py. Renaming the folder can break upgrades unless your server is configured for the new name.

A list of folders on the server where Odoo searches for applications. Your administrator adds custom_addons to this list so third-party apps are found without mixing them with core Odoo code.

A special view of Odoo for administrators. It shows extra menus (Update Apps List, technical fields) that regular hotel staff never need. Turn it on only when installing or troubleshooting apps.

Rebuilds the catalog of apps Odoo can install. Required after you copy a new addon folder and restart – otherwise Hotel Management will not appear in search results.

The friendly title shown on the Apps screen. It may differ slightly from the folder name. Always search “Hotel Management” to find this module.

Pre-built sample records (properties, rooms, bookings) shipped with the addon. Helpful for training. Not added to databases that were created without demonstration data – only real configuration is used there.

Security group for everyday operations: create bookings, use front desk screens, housekeeping, maintenance, guest profiles, and open folios. Cannot access Configuration or manager-only finance menus.

Security group that includes User rights plus property setup, rate plans, cancellation policies, guest invoices, deposit invoices, employee attendance, and all reporting tools.

The application menu that appears once the addon is installed and the logged-in user has Hotel User or Hotel Manager access. If missing, the problem is almost always permissions or the app not fully installed.