Setup Project Gantt Planner

• Get the addon package. Download the latest version of Projects Gantt Planner from your vendor, partner, or internal file share. You should receive a folder named projects_gantt_planner (or a ZIP file that contains this folder).
• Check the folder name. Inside the package, the main folder must be called exactly projects_gantt_planner. Odoo uses this technical name to find the module. Do not rename it.
• Confirm it is for Odoo 17. This guide is for version 17.0. Using the addon on a different Odoo version may cause errors.
• Keep a backup. Save a copy of the downloaded folder in a safe place before uploading, so you can reinstall or restore it later if needed.

• Locate your addons path. On the server, Odoo reads addons from one or more folders. Common locations are:
  • addons – standard Odoo addons folder
  • custom_addons – a separate folder many companies use for custom modules

  Your administrator knows which path is configured in the Odoo config file (odoo.conf), in the setting addons_path.

• Copy the folder. Upload or copy the entire projects_gantt_planner folder into that addons directory. The result should look like:.../custom_addons/projects_gantt_planner/

  Inside you should see files such as __manifest__.py and folders like models, views, and static.

• Do not nest the folder twice. A common mistake is uploading custom_addons/projects_gantt_planner/projects_gantt_planner/. Odoo expects only one level: the manifest file must sit directly inside projects_gantt_planner.
• Set file permissions (Linux servers). The Odoo system user must be able to read the folder. Your server administrator usually handles this.

• Why restart? Odoo scans addon folders when it starts. After you add a new folder, a restart is required so Odoo can see projects_gantt_planner.
• Ask your administrator to restart Odoo. This may be a Windows service, a Linux systemd service, or a Docker container – depending on how your company hosts Odoo.
• Wait until Odoo is fully running again. Open your Odoo URL in the browser and confirm you can log in normally before continuing.

• Log in as an administrator – a user who can open Settings and install apps.
• Open Settings. Click the Settings app (gear icon) from the main Odoo home screen.
• Scroll to the bottom of the Settings page. Find the link Activate the developer mode (or Developer Tools → Activate the developer mode).
• Click it. The page reloads. Developer mode is now on. You may see extra technical menus and a bug icon – this is normal.
• Why is this needed? Developer mode unlocks the Update Apps List option, which is required after adding a new addon folder manually. Without it, Odoo may not show your new module in the Apps list.

• Open the Apps menu. From the Odoo home screen, click Apps.
• Open the Apps list menu. Click the ⋮ (three dots) or the Update Apps List option in the top menu (visible when Developer Mode is active).
• Confirm the update. A dialog asks you to confirm. Click Update. Odoo will scan all addon folders again.
• Wait for completion. This may take a few seconds to a minute. When finished, new modules – including Projects Gantt Planner – become searchable in Apps.
• Remove the “Apps” filter if needed. In the Apps search bar, clear filters like Apps so you can also find modules that are not yet installed.

• Go to Apps and type Projects Gantt Planner or Gantt in the search box.
• Find the correct module. Look for the app named Projects Gantt Planner under category Services / Project. The technical name is projects_gantt_planner.
• Install Project first (if not already installed). This addon requires the standard Project app. If Project is not installed, install it before or together with the Gantt addon.
• Click Activate (or Install). Odoo installs the module. Wait until the process completes – do not close the browser tab during installation.
• Installation succeeded? You should see no error message. The button changes to Installed or offers an Upgrade option for future updates.

• What is demo data? Sample projects and tasks that help you explore the Gantt chart immediately, without creating everything from scratch.
• When does it install? Demo data loads automatically only if your Odoo database was created with demo data enabled, or if you install the module on a database that uses demo content. On a clean production database, demo data is usually not loaded – and that is normal.
• What demo content is included? This addon can create sample timeline projects (such as a timeline lab with tasks spread across weeks) and planned dates on standard project demo tasks. Your administrator sees this only when demo mode is active for the database.
• Production systems: Most live company databases should not use demo data. After installation, create your own projects and tasks, then set Planned Start and Planned End on tasks to see them on the Gantt.
• Want to practice first? Ask your administrator to set up a separate test database with demo data enabled. Use that sandbox to learn the Gantt before working on real projects.

• Open Settings → Users & Companies → Users. You need administrator access for this step.
• Select the user who should use the Gantt (for example, a project manager or team member).
• Open the Access Rights tab on the user form.
• Find the Project section. Projects Gantt Planner does not add a separate permission checkbox – it uses the standard Project app rights. Set one of:
  • User – can use projects and tasks (suitable for most team members)
  • Administrator – full project control (suitable for project managers)
• Ensure the Project app is enabled for that user. Under Application Access or the user’s home menu, the Project app must be available. Without Project access, the Gantt menus will not appear.
• Save the user record. Repeat for every team member who needs the Gantt timeline.
• Settings access (admins only). To change Gantt defaults (scale, colors, weekends), a user also needs access to Project → Configuration → Settings, which typically requires project manager or administrator rights.

• Log out and log back in as the user you configured – or press Ctrl + F5 (hard refresh) in the browser to clear cached menus.
• Open the Project app from the Odoo home screen.
• Look for the new menu: Projects Gantt Planner. You should see it in the main Project menu with these entries:
  • Tasks – all tasks on the Gantt timeline
  • Projects – projects shown as timeline bars
  • By Project – tasks grouped under each project
• Click Tasks. The Gantt view should open. If tasks have planned dates, you will see colored bars on the timeline.
• Success checklist:
  • Menu Projects Gantt Planner is visible under Project
  • Gantt view opens without an error
  • You can switch view modes using the icon bar (Gantt, List, Kanban, etc.)
  • Opening a project form shows a Tasks stat button when tasks exist
• If the menu is missing, go back to Step 8 and confirm the user has Project access. Also confirm Step 6 completed without errors.

Odoo identifies modules by their folder name on disk. For this product it is always projects_gantt_planner. Renaming breaks installation.

What you search for when installing. Matches the title in __manifest__.py: Projects Gantt Planner.

A server configuration value. Your IT team adds custom_addons here so Odoo can discover modules you upload. End users normally do not edit this file.

A switch in Settings for administrators. It exposes tools needed after manually copying an addon folder. It does not need to stay on forever – but keep it on until installation is finished.

Lets a person open the Project app, see tasks, and use the Gantt. This is the minimum right for everyday planners and team members.

Gives full control over projects and configuration. Assign to project managers who also need to change Gantt settings under Project Configuration.

Practice content – not real business data. Helpful on training databases; usually skipped on live production systems.

Your proof that installation worked. Appears under Project once the module is installed and the user has Project app access.