Cytomine Bigpicture Edition is an assemblage of modules from the Cytomine Community Edition and additional modules specific to the BIGPICTURE project (including libraries coming from https://github.com/imi-bigpicture).

This repository provides a way to install Cytomine based on Docker compose.

The requirements to install Cytomine BigPicture edition are:

• Docker Engine
• Git
• Have the root permissions on the machine where you want to install Cytomine

The root permissions is only needed for Docker

To install Cytomine BigPicture edition, follow the steps below:

1. Clone the repository on your machine:

git clone --branch BP2025.1 https://github.com/Cytomine-ULiege/Cytomine-bigpicture-edition.git

2. Enter the cloned repository:

cd Cytomine-bigpicture-edition/

3. Add your configurations in the cytomine.template file if you want to change default values (like URLs and/or SMTP setup).

4. Launch the Cytomine installer:

sudo docker pull cytomine/installer
sudo docker run -v $(pwd):/install --user "$(id -u):$(id -g)" --rm -it cytomine/installer:latest deploy -s /install

This will create all the folders and files necessary to launch Cytomine with Docker Compose

5. Launch cytomine:

sudo docker compose up -d

Cytomine is now ready to be used!

If you have kept the default values in cytomine.template, Cytomine is available at http://localhost.

By default, an admin account has been created. To connect to Cytomine in your browser, retrieve the admin password by opening the generated cytomine.yml file and looking for the ADMIN_PASSWORD key, as shown in the snippet below:

services:
  default:
    bioformat:
      constant:
        BIOFORMAT_PORT: 4321
    core:
      constant:
        ADMIN_PASSWORD: <generated-password>

or by running the following command:

cat cytomine.yml | grep ADMIN_PASSWORD:

The Bigpicture edition installation procedure, the documentation is available at https://doc.uliege.cytomine.org/admin-guide/bp/installation

See the documentation to import datasets.