Install Cayamanan ERP

Use this guide to set up Cayamanan 19.0 on a server managed by your team. You will prepare the required software, create a database, install Cayamanan, and open it for the first time.

Important

Download Cayamanan only from an official project page when it is available. Until then, use the Community page or contact form rather than an unverified copy.

What you need

This section is for your technical team. Use a supported 64-bit Linux server for a live system. Install Python 3.12, PostgreSQL 16, a C compiler, PostgreSQL client headers, LDAP/XML/XSLT/image libraries required by requirements.txt, and Node tooling needed by the release. Package names differ by operating system, so this system-package step is environment-specific and must be reviewed by the server owner.

Prepare Python

From the reviewed Cayamanan source directory:

python3.12 -m venv .venv
.venv/bin/python -m pip install --upgrade pip wheel
.venv/bin/python -m pip install -r requirements.txt

The last command is the validated project dependency entry point. If a package needs a missing operating-system library, install that library through your system package manager, then repeat the command. Do not run pip as root.

Prepare PostgreSQL

Create a dedicated PostgreSQL role that can create databases. The exact command depends on your authentication policy. One local development example is:

createuser --createdb cayamanan
createdb --owner=cayamanan cayamanan_demo

Production credentials, network rules, encryption, and backups are environment-specific. Do not expose PostgreSQL directly to the internet.

Create the first database

Run from the source root and replace database connection values for your environment:

.venv/bin/python odoo-bin \
  --database=cayamanan_demo \
  --db_host=127.0.0.1 \
  --db_port=5432 \
  --db_user=cayamanan \
  --addons-path=addons \
  --init=web_cayamanan,l10n_ph,sale_management,purchase_stock,crm \
  --without-demo \
  --stop-after-init

The technical names in the command must be copied exactly. web_cayamanan applies Cayamanan product branding. l10n_ph provides the Philippine accounting localization foundation. sale_management, purchase_stock, and crm install the workflows covered by the public demo. Your reviewed version may add custom addon paths or modules; record those choices rather than copying an unknown live-system command.

Start a local test server

.venv/bin/python odoo-bin \
  --database=cayamanan_demo \
  --db_host=127.0.0.1 \
  --db_user=cayamanan \
  --addons-path=addons \
  --http-interface=127.0.0.1 \
  --http-port=8069

Open http://127.0.0.1:8069 from the same computer. This is for local testing, not a public service definition. A public business system also needs a process manager, reverse proxy, TLS, restricted database management, secure secrets, monitoring, mail, and tested backup and restore. Keep these implementation details with your technical team.

After the login page appears, continue with Set up your first company.