# Configuration

# Add Cytomine registry to MicroK8s

After installing the Cytomine, you will have to set up a configuration file to allow MicroK8s to communicate with the private registry.

  1. Get the IP address of the registry container, using

    sudo docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' cytomine-registry-1
    
    1
  2. Create the directory and configuration file:

    • mkdir -p /var/snap/microk8s/current/args/certs.d/<registry-ip>:5000
    • touch /var/snap/microk8s/current/args/certs.d/<registry-ip>:5000/hosts.toml

    Where <registry-ip> is the output of step 1.

    Normally, sudo privileges are not required.

  3. Add the following lines inside the hosts.toml file:

    server = "http://<registry-ip>:5000"
    [host."http://<registry-ip>:5000"]
    capabilities = ["pull", "resolve"]
    
    1
    2
    3
    4
  4. Restart MicroK8s to have the new configuration loaded:

    microk8s stop
    
    1
    microk8s start
    
    1

More information are available at the How to work with a private registry (opens new window) section of the official documentation of MicroK8s.

MicroK8s is now ready for use by Cytomine, you can proceed with the installation.

Last Updated: 9/10/2025, 3:37:33 PM