# Install Community Edition 2023.1

TIP

If you experiment any issue, please describe your problem precisely in our ticket system on Github. (opens new window)

WARNING

  1. This version opens a new way to manage data within Cytomine. It is recommended for new projects starting from scratch, but not to upgrade projects already using any Cytomine Community Edition Legacy (version 2 or 3). Please contact us if you have such needs (opens new window).
  2. Community Edition 2023.1 do not include any AI engine for the moment. This will be added in next release. So if you need to run AI within your Cytomine, please consider to install the last release of Cytomine Community Edition Legacy.

# Install a Cytomine local instance

This installation procedure is for desktop or laptop computers running a Debian based Linux operating systems.

You must have installed Docker engine (opens new window) and git, and have root permissions (sudo in Debian/Ubuntu).

  1. Clone the repository on your computer:
git clone --branch CE2023.1 https://github.com/cytomine/Cytomine-community-edition.git
1
  1. Go into the cloned folder:
cd Cytomine-community-edition
1
  1. Launch the Cytomine installer. This will create all the folders and files necessary to launch Cytomine with Compose:
sudo docker pull cytomine/installer
sudo docker run -v $(pwd):/install --user "$(id -u):$(id -g)" --rm -it cytomine/installer:latest deploy -s /install
1
2
  1. Edit the file cytomine.yml if you want to change default values (like URLs and/or SMTP setup).
  2. Relaunch the installer (see step 3) to apply the changes made in the file cytomine.yml.
  3. Launch cytomine:
sudo docker compose up -d
1

⚠️ As a side effect, this last command will write in your local /etc/hosts file.

  1. Use Cytomine : If you have kept the default values your Cytomine is now available on http://cytomine.local. By default, an admin account has been created for you. To connect to the platform in your browser, retrieve the randomly generated admin password by opening your cytomine.yml file and go to services: default: core : constant: ADMIN_PASSWORD:. You can use this password with the adminusername to get authenticated on your Cytomine. Once authenticated, update this admin password to a more personal one.

# Update configuration

If you want to change the configuration of a running instance :

  1. Update your configuration in the cytomine.yml file.
  2. Relaunch the Cytomine installer to update your configuration file :
sudo docker pull cytomine/installer
sudo docker run -v $(pwd):/install --user "$(id -u):$(id -g)" --rm -it cytomine/installer:latest deploy -s /install
1
2
  1. Restart your running instance :
sudo docker compose down
sudo docker compose up -d
1
2

# Stop Cytomine

To stop your Cytomine instance, use :

sudo docker compose down
1

The server is stopped but data (databases and images) are preserved.