CMDBuild 4 READY2USE on Ubuntu 24.04 – Full Installation Guide

✅ CMDBuild 4 READY2USE on Ubuntu 24.04 – Full Installation Guide (with Working Fixes)

🧱 1. System Prep


sudo apt update && sudo apt upgrade -y
sudo apt install openjdk-17-jdk tomcat10 tomcat10-admin postgresql postgresql-contrib unzip wget -y

🐘 2. Install and Configure PostgreSQL 17 + PostGIS

a. Ensure cluster is running on v17


sudo pg_lsclusters

If 15/main exists, remove it:


sudo pg_dropcluster 15 main --stop

b. Create DB user and DB


sudo -u postgres createuser -P cmdbuild
# Use password: CMDBUILDUSERPASS

sudo -u postgres createdb -O cmdbuild cmdbuild
sudo -u postgres psql -d cmdbuild -c "CREATE EXTENSION postgis;"

c. Set the PostgreSQL admin (postgres) password


sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'POSTGREMASTERPASS';"

🌐 3. Download and Deploy CMDBuild WAR

a. Download CMDBuild 4 READY2USE WAR


wget https://sourceforge.net/projects/cmdbuild/files/ready2use-2.4/ready2use-2.4-4.0.4.war/download -O cmdbuild.war

b. Deploy to Tomcat


sudo cp cmdbuild.war /var/lib/tomcat10/webapps/

c. Wait for Tomcat to extract the WAR (30–60 seconds), then:


ls /var/lib/tomcat10/webapps/cmdbuild

📦 4. Download READY2USE Resources

You will want to do this on your computer, not the server.  

Find the lastest file from the SourceForce IE: https://sourceforge.net/projects/cmdbuild/files/ready2use-2.4/
In my case the latest link was:
https://master.dl.sourceforge.net/project/cmdbuild/ready2use-2.4/ready2use-2.4-4.0.4-resources.zip?viasf=1

After unzipping that, you’ll now have:


ready2use-resources/
├── database/
│   ├── empty.dump
│   └── demo.dump
Note for step 6: If you are going to use this server for learning only, use the demo.dump in step 6, otherwise if this is for production, just use the empty.dump in step 6.

⚙️ 5. Fix CMDBuild Config Directory Permissions


sudo mkdir -p /var/lib/tomcat10/webapps/cmdbuild/WEB-INF/conf
sudo touch /var/lib/tomcat10/webapps/cmdbuild/WEB-INF/conf/database.conf
sudo chown -R tomcat:tomcat /var/lib/tomcat10/webapps/cmdbuild
sudo systemctl restart tomcat10

🌐 6. CMDBuild Web Setup (via Browser)

Go to:


http://localhost:8080/cmdbuild

a. Drop existing DB if needed (from any previous failed installs):


sudo -u postgres dropdb cmdbuild

⚠️ DO NOT recreate it manually again — let CMDBuild do that. b. Fill out setup wizard

  • Type: Upload backup
  • Backup file: empty.dump (from ready2use-resources/database/)
  • Name: cmdbuild
  • Host: localhost
  • Port: 5432
  • Username: cmdbuild
  • Password: CMDBUILDUSERPASS
  • Admin username: postgres
  • Admin password: POSTGREMASTERPASS

Click:

  • ✅ Test database connection
  • ✅ Configure

If you get database already exists, drop it again using dropdb. c. Wait for it to apply configuration
Then click: ✅ Apply patches

🔐 7. Login

Go to:


http://localhost:8080/cmdbuild

Login with:

  • Username: admin
  • Password: admin

You'll be asked to set a new password.