]po[ V5.2 Docker Installer on Debian Bookworm

This Docker installer is one of the three official installers for ]project-open[. Please see the list of all installers including the official VMware distribution and the installers for Windows and Linux. Please also see the README.md on GitHub .

Requirements

We assume you are running a docker environment >= 27.5.1 on a Linux host.

We have tested this procedure with Ubuntu Server 24.04 and the the Docker version that comes with it. So to install Docker please execute:

apt install -y docker.io docker-compose-v2

However, it should be sufficient to follow the instructions at docker.com on to how to install and setup a docker development environment.

The following instructions assume that you have configured docker to be used as a normal user, so there is no need to become 'root' in order to run docker commands. You can configure this by adding your local Linux user to the group "docker":

usermod -aG docker myuser

The Build Environment

Please clone the Docker installer GitHub repo to a local directory.

git clone https://github.com/project-open/installer-docker.git

Building the System

The installer needs several external sources, so you have to start with the "build.bash" script:

$ cd installer-docker
$ ./build.bash

This will clone two additional GitHub repos "installer-linux" and "packages", together with some 200 submodules.

After that you can start the actual process with:

$ docker compose up

This may take between 1 and 60 minutes, depending on your hardware.

As a result you should see debugging output from two different containers, "postgresql-1" and "projop-1".

Please open a 2nd shell and check the running containers:

$ docker ps
CONTAINER ID   IMAGE                    PORTS                                             NAMES
7a93414117ce   project-open-v52-projop  0.0.0.0:8080->8080/tcp, 0.0.0.0:8445->8443/tcp    project-open-v52-projop-1
57cba401208e   postgres:latest          5432/tcp                                          project-open-v52-postgres-1

Now point your favorite browser to http://localhost:8080/ and you should get the ]project-open[ login page. Enter with:

• Email: 'sysadmin@tigerpond.com'
• Password: 'system'

Fix File Storage Paths

The default paths in the data-model don't work with the docker installation.

Please enter the following URL: http://localhost:8080/docker-fix-path-parameters

This little script should fix the paths for the file storage system and the backup.

You can review the paths in Admin -> Parameters.

Portlet "Upgrade Information"

Please check if there is an "Upgrade Information" portlet on the right on page /intranet/index.
In this case please click on the "Install packages" link and follow the instructions. 
This process will update the data-model to keep it in sync with the latest code updates.
No "Upgrade Information" portlet means that code and data-model are already in sync.

Portlet: System Configuration Wizard

Please follow the "System Configuration Wizard" provide some basic information about the organization that should run ]po[. ]po[ ist vast (>200 functional modules), so we try to strike a balance between simplifying the system and providing you with functionality.

Create a Project with a Gantt Editor

Please got to the "Projects" tab and choose "New Project". Choose the "Classic/Gantt Project" type and press "Create Project" at the bottom of the screen.

Fill in the fields Project Name, a customer and a Project Manager and press "Create Project" at the bottom of the screen.

You should now see a project page (URL: "/intranet/projects/view?project_id=123456") where you can start adding tasks to your project.

Please also add a few more users to your project in the "Project Members" portlet on the same page.

Stopping and Starting

After playing around with ]po[ you can stop the installation:

$ docker compose down

To start again please use:

$ docker compose up

To remove the images completely and to start over (but not the source code):

$ ./clean.bash

Issues and Support

Please see the Issues section  of the Docker installer for support.