Local Development Setup

  • Updated on May 20, 2025
  • Published on Mar 19, 2025
  • 1 minute(s) read
  • JW
 Prev Next

Prerequisites

  • Access to Zebroo Sync github repo (get in touch with us if you need access)

  • Python

  • pip

Clone repo

On your target machine:

git clone git@github.com:Odoo-Ninjas/zebroo-sync.git
cd zebroo-sync

Install required packages

Use Gimera: our own package installation config tool, designed to simplify Odoo requirement installation. Check it out here.

Install Gimera

pipx install gimera

Install project requirements

Install all package requirements, as described in gimera.yml, including Odoo:

gimera apply

Grab a coffee ☕️ It can take a few minutes to receive all objects (~10GB).

Tip: Once Gimera has finished resolved deltas, it appears to halt for a minute while creating a zipped cache, to speed up the next time those packages need installing. If you cancel the command, it can result in a corrupted tarball that needs removing (rm ~/.cache/gimera/github.com-odoo-odoo.tar.gz) and the installation needs repeating. To monitor cache creation progress:

#Expected output includes something like: -rw-r--r--  1 root root 9.1G Mar 17 10:13 github.com-odoo-odoo.tar.gz
#File size should increase if the command is re-run, indicating that it's being actively updated.
ls -lh ~/.cache/gimera

Start project

The following commands use our Wodoo CLI, written to provide a clean and easy-to-use Odoo CLI. But you can now run the Odoo code as you usually do, as preferred.

#Reload and link modules. Create a docker-compose file. Initiates the database with demo data (omit "--demo" if not wanted)
odoo reload --demo

#Build required docker container according to the docker-compose file
odoo build 

#Reset database and initialise odoo instance
#Note: it's expected that there are warnings like "Module zbsync_specification not installed!"
odoo -f db reset

#Optionally, update installed Odoo modules to include all zSYNC modules
#Otherwise modules will need activating manually via the Odoo UI
odoo update

#If permission is denied for update.log
sudo chmod u+rwx update.log

#Start the dev instance
odoo dev 

#Run debug mode
#Expected output is something like: "PROXY Port: 8898"
debug

In a second terminal, get the address for your now running instance

#Output should include a url field, to access your odoo instance
odoo status

Login with default credentials (admin, admin)

Activate Zebroo Sync module

Only required if the odoo update step was skipped above.

Navigate to Apps, clear all preselected search filters and search for the module zbsync. Activate it and wait for the installation to complete.

Now the Zebroo Sync app should have been activated and you can navigate to it via the top-leftmost menu

Congratulations and happy zSYNCing! 🎉

What next?

Learn how to Build Your First Pipeline.

Related articles