Installation

Cetmix Tower is a set of Odoo modules that can be installed like any other Odoo module. This means that they should be located in your Odoo addons directory.

Supported Odoo Versions

Supported versions may change. Check the GitHub repository or Odoo App Store for current support.
- 14.0 — EOL, community support only
- 16.0 — stable
- 17.0 — stable
- 18.0 — stable

Installation Methods

From GitHub

Clone the https://github.com/cetmix/cetmix-tower repo and put the modules into your Odoo addons directory.

Source installation: required OCA modules

When installing from source, ensure these OCA modules are available in your addons path:
- web_notify — Cetmix Tower Server dependency
- rpc_helper — Cetmix Tower Server dependency
- queue_job — required for Cetmix Tower Server Queue

From the Odoo App Store

Download the Cetmix Tower module for your Odoo version from the App Store. For example: 16.0, 18.0. Other versions may be available—search for "Cetmix Tower" on apps.odoo.com.
Unzip the downloaded file and put the modules from the archive into your Odoo addons directory.

Using a Docker image

The official Docker image allows you to set up Cetmix Tower quickly with all dependencies pre-installed. This image includes all modules from the GitHub repository and features the Responsive Backend Theme from the OCA for an enhanced user experience.

Note: This Docker image is intended primarily for testing, demo purposes, or standalone server management without additional Odoo modules. If you plan to integrate Cetmix Tower with other Odoo modules, consider installing it as a regular Odoo module within your Odoo project.

This image functions similarly to the Odoo official image with the main difference that it does not expose an additional addons volume. All required modules are built into the image and can be installed through the "Apps" menu.

Below you will find a sample docker-compose.yml file which runs a new Odoo instance with demo data and Cetmix Tower Server installed. You can access it navigating to http://localhost:8069 and using login admin and password admin

services:
  web:
    image: cetmix/cetmix-tower:latest
    depends_on:
      - db
    # Default Odoo port
    ports:
      - "8069:8069"


    # This command will install the following modules:
    #
    # - Cetmix Tower Server with OCA queue job (async command execution)
    # - Responsive frontend theme from OCA
    #
    # Will install demo data.
    # Login/password: admin/admin
    # Important: you might need to restart the container after first run for the job runner to start
    command: ["--init=cetmix_tower_server_queue,web_responsive", "--database=tower_demo"]

    # Same as above, but will disable demo data
    # command: ["--init=cetmix_tower_server_queue,web_responsive", "--database=tower_demo", "--without-demo=all",]
  db:
    image: postgres:17
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_PASSWORD=odoo
      - POSTGRES_USER=odoo

Note

This Docker image is intended primarily for testing, demo purposes, or standalone server management.
If you plan to integrate Cetmix Tower with other Odoo modules, consider installing it as a regular Odoo module within your Odoo project.

Odoo timeout and performance

For Odoo timeout limits and async execution (queue workers), see Configuration > Odoo Server Settings.

Available Modules

Cetmix Tower

This is a meta module that is used to publish all other modules as a single module in the Odoo App Store. When installed, it will install all other modules automatically.

Cetmix Tower Server

This is the main module that provides the Cetmix Tower core functionality. It depends on the OCA modules web_notify and rpc_helper, and on cx_web_refresh_from_backend (included in the Cetmix Tower repository).

Cetmix Tower Server Queue

This module provides the queue system that allows to run commands and flight plans asynchronously. This module depends on the OCA Queue Job module.
If you are installing Cetmix Tower from source code, please ensure that this module is available in your Odoo instance.
If you are using Docker Installation this module is already present in the image.

Warning

You should restart your Odoo instance after installing this module.

Cetmix Tower YAML

This module allows exporting and importing Cetmix Tower records to/from YAML files.

Note

This module requires pyyaml Python package to be installed in your Odoo instance. If you are installing Cetmix Tower from source code, please ensure that this module is available in your system. You can install it using the pip install pyyaml command.
If you are using Docker Installation this module is already present in the image.

Cetmix Tower Git

This module provides a set of helper functions to interact with Git repositories. This module depends on the Cetmix Tower YAML module.

Note

This module requires the giturlparse Python package. If installing from source, run pip install giturlparse before installing the module.

Cetmix Tower Webhook

This module implements incoming webhooks for Cetmix Tower. Webhooks are authorized using configurable authenticators that can be reused across multiple webhooks. Webhooks and authenticators can be exported and imported via YAML, making them easy to share. Although part of Cetmix Tower, the module can also be used to trigger or integrate with other Odoo applications.

Installing the Modules

Once you have downloaded the modules or created your container, install them in Odoo by following these steps:

Install all modules at once

Go to the Apps menu.
Search for cetmix_tower.
Install the Cetmix Tower module. It will install all other modules automatically.

Install only selected modules

Remove the default 'Apps' filter from the search string.
Search for cetmix_tower.
Install the Cetmix Tower modules you would like to use in your system. Please note that supplementary modules depend on the Cetmix Tower Server module so it will be installed automatically with any of them.

After the installation

Follow these steps to get started:

Configuration — Configure Odoo server settings (timeouts, queue workers) and review General Settings.
User Settings — Set up access levels and roles for users.
Create a Server — Add your first server to manage.
Launch a Jet — Create and run an application on the server.
Troubleshooting — If commands are not running or you hit timeouts.