Skip to main content

Cocosplate Installation

Several ways of installation are possible the preferred way is a containerized setup with docker which works with Windows and Linux. Additionally you can evaluate the system by using the Windows Setup to install it in Windows 10 and 11.

Setup with Docker​

By using Docker you can easily setup and maintain an installation. Docker can be downloaded from https://www.docker.com/products/docker-desktop for a installation on Windows or Mac OS X systems. If you are familiar with Linux, you can use the Docker installation provided by your favorite distribution.

  1. Get the file cocosplate.zip and extract it

  2. Start the system by issuing the following command in the cocosplate directory of the zip-file:

    docker compose up -d

    This will download the latest images and start the server.

  3. Open your browser on http://localhost:8081, it will show a login screen.

You can then log in with the username admin and the initial password Login-AI-Workflow-257.

You may proceed to the initial configuration.

The cocosplate.zip file contains a docker-compose.yml file and preconfigured environment files;

cocosplate.zip
  + docker-compose.yml
  + .env
  \ service.env

Some of the default values defined in the .env files may be changed for deployment, for example INITIAL_ADMIN_PASSWORD.

Updating an existing installation​

To update your installation to the latest version simply type

docker compose pull

from a terminal in the directory you chose above.

It is not recommended to directly expose the system to the internet due to the nature of the application which allows to visually create runnable workflows on the server that might have a security impact. Therefore, only intranet installations are supported.

Windows Setup​

The setup installs the system as a windows service and optionally sets up a PostgreSQL database. If you already have a database choose the installation without it otherwise the database installation is updated.

Installation with PostgreSQL​

This will install everything needed to successfully run Cocosplate AI. The PostgreSQL main password is set to 'postgres'.

Installation without Database​

This advanced setting requires some manual steps, after setup you may have to manually adjust the file cocosplate-ai.l4j.ini to specify the database credentials and host.

-Dspring.datasource.url=jdbc:postgresql://<database host>:5432/<database schema>
-Dspring.datasource.password=<password>
-Dspring.datasource.username=<username>

After changing the settings restart the service Cocosplate AI in the Windows Task manager. Only PostgreSQL databases > v.9.0 are supported.