ZEISS Knowledge Base
Help
ZEISS Knowledge Base

Installation & Setup

System Requirements

ZEISS Microscopy Software

Minimum System Requirements

Recommended System Requirements

Intel® CPU with 6 cores, 3.0 GHz clock frequency (e.g. Intel® Core® i5-12500 CPU)

Intel® Xeon® CPU with 12 cores, 3.2 GHz clock frequency (e.g. Intel® Xeon® W5-3425)

16 GB RAM

64 GB RAM

Graphics adapter with support for resolutions of at least 1920 x 1200, 32 Bit true color, DirectX® 12.0 or higher (e.g. integrated Intel® UHD Graphics 670 or dedicated graphic card NVIDIA® RTX A1000 8GB)

Graphics adapter with support for resolutions of 3840 x 2160 Pixel (“4K”), 32 Bit true color, DirectX® 12.0 (or higher), OpenGL® 4.5 (or higher) (e.g. dedicated graphic card NVIDIA® RTX A4000 16 GB)

Hard drive
1 x 512 GB SSD NVMe and 1 x 8 TB HDD SATA 6Gb/s

Hard drive
1 x 2 TB SSD NVMe and 2 x 12 TB HDD SATA 6Gb/s (configured as 12 TB RAID 1)

2 x USB 2.0 and 2 x USB 3.0

4 x USB 2.0 and 2 x USB 3.0

Monitor: 24" TFT display, vertical resolution 1200 pixels at least

Monitor: 27" TFT display, vertical resolution 1440 pixels at least

PCIe interface: 2 available PCI Express x8 Gen2 slots for camera interface cards

Microsoft® Windows® 11 x64 Enterprise, no special customer adapted versions. We recommend Windows 11 Enterprise IoT versions as ZEN core 3.13 was tested with Windows 11 IoT Enterprise LTSC version 24H2. Other Windows 11 Versions (e.g., Home or Pro) have not been tested.

Windows N editions do not support basic media functionality, so that they cannot be used for the ZEN core application.

Recommendation: Windows® 11 should be updated to the latest build version (e.g. 22631.3737) before installing ZEN core.

Reference: https://learn.microsoft.com/en-us/windows/release-health/release-information
https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information

Drivers for NVIDIA graphics cards in our workstations should also be downloaded from hp website (not from NVIDIA) e.g. for hp Z8 G5 workstation: https://support.hp.com/us-en/drivers/swdetails/hp-z8-fury-g5-workstation-desktop-pc/2101236624/swItemId/vc-339200-1

For software resp. system operation, the user must be logged on with at least user privileges. For the software installation procedure, the user must be logged on with an account owning local administrator rights.

For specific hardware requirements of microscope systems or software modules please refer to the corresponding system or module description.

Minimum System Requirements for ZEN core TCA Systems

Axio Imager 2 and Axio Zoom.V16

Parameter

Description

Processor

Intel® Xeon® CPU with 4 cores, 3.8 GHz clock frequency, e.g. Intel® Xeon® Gold 5222 *

Memory

128 GB RAM

Graphics adapter

Support for resolutions of 3840 x 2160 pixels (“4K”), 32 Bit true color, DirectX® 12.0 (or higher), OpenGL® 4.5 (or higher),
e.g. dedicated graphic card NVIDIA Quadro RTX4000 8 GB

Hard drive

1 x 512 GB SSD NVMe and 2 x 6 TB HDD SATA 6Gb/s (configured as 6 TB RAID 1)

USB interface

4 x USB 2.0 and 2 x USB 3.0

PCIe interface

2 available PCI Express x8 Gen2 slots for camera interface cards

Monitor

27" TFT display, vertical resolution 1440 pixels at least

Operating System

Microsoft® Windows® 11 Enterprise, no special customer adapted versions.

Windows N editions do not support basic media functionality, so that they cannot be used for ZEN core application.

The user must be logged in with at least user privileges. For the software installation procedure local administrator rights are required.

For specific hardware requirements of microscope systems or software modules please refer to the corresponding system or module description.

Axioscope 7 and SteREO Discovery.V8

Parameter

Description

Processor

Intel® CPU with 6 cores, 3.3 GHz (e.g. Intel® Core® i5-10600 CPU)

Memory

64 GB RAM

Graphics adapter

Support for resolutions of at least 1920 x 1200 pixels, 32 Bit true color, DirectX 12.0 or higher,
e.g. integrated Intel® UHD Graphics 630 or dedicated graphic card NVIDIA Quadro P1000 4GB

Hard drive

1 x 512 GB SSD NVMe and 1 x 8 TB HDD SATA 6Gb/s

USB interface

2 x USB 2.0 and 2 x USB 3.0

Monitor

24" TFT display, vertical resolution 1200 pixels at least

Operating System

Microsoft® Windows® 11 Enterprise, no special customer adapted versions.

Windows N editions do not support basic media functionality, so that they cannot be used for ZEN core application.

The user must be logged on with at least user privileges. For the software installation procedure local administrator rights are required.

For specific hardware requirements of microscope systems or software modules please refer to the corresponding system or module description.

Minimum System Requirements for ZEN core NMI Systems

Axio Imager 2 and Axio Observer 7

Parameter

Description

Processor

Intel® Xeon® CPU with 4 cores, 3.8 GHz clock frequency, e.g. Intel® Xeon® Gold 5222

Memory

128 GB RAM

Graphics adapter

Support for resolutions of 3840 x 2160 pixels (“4K”), 32 Bit true color, DirectX® 12.0 (or higher), OpenGL® 4.5 (or higher),
e.g. dedicated graphic card NVIDIA Quadro RTX4000 8 GB

Hard drive

1 x 512 GB SSD NVMe and 2 x 6 TB HDD SATA 6Gb/s (configured as 6 TB RAID 1)

USB interface

4 x USB 2.0 and 2 x USB 3.0

PCIe interface

2 available PCI Express x8 Gen2 slots for camera interface cards

Monitor

27" TFT display, vertical resolution 1440 pixels at least

Operating System

Microsoft® Windows® 11 Enterprise, no special customer adapted versions.

Windows N editions do not support basic media functionality, so that they cannot be used for ZEN core application.

The user must be logged in with at least user privileges. For the software installation procedure local administrator rights are required.

For specific hardware requirements of microscope systems or software modules please refer to the corresponding system or module description.

Requirements for Docker Desktop

For some functionality, you additionally need the software Docker Desktop on your PC to be able to use it. This includes the download and use of dedicated AI models, for example for instance segmentation. You can install Docker Desktop with the ZEISS Microscopy Installer. For details about Docker Desktop, refer to their documentation at https://docs.docker.com/desktop/, and for system requirements see https://docs.docker.com/desktop/install/windows-install/. Also note the following special conditions:

  • If you work with Docker on a system with multiple Windows users, always sign out of your Windows account to initiate a shutdown of Docker when you have finished your work. Otherwise the other users may have problems using Docker.
  • Docker containers from arivis Cloud are not shared between different Windows user accounts and may need to be re-downloaded to be available to other users.

Docker requires that BIOS-level hardware virtualization support is enabled and can either run with Hyper-V or with WSL2. We recommend using WSL2 if possible. WSL (short for Windows Subsystem for Linux) is a feature of Microsoft Windows that allows you to use of a Linux environment within Windows. For WSL2, the WSL2 feature has to be installed and activated. For more information, see the system requirements linked above and https://docs.docker.com/desktop/features/wsl/. WSL2 provides improvements to file system sharing and boot time, and Docker Desktop uses the dynamic memory allocation feature in WSL2 to improve the resource consumption.

If you do not or cannot use WSL2, the resources allocated to Docker are not automatically managed by Windows and might not be big enough in certain instances. In such a case, you can also adapt the resource allocation manually, see Adapting the Resource Allocation for Docker Desktop Manually. Additionally, Docker Desktop has experimental features that are activated by default, which can lead to an increased resource consumption, for example disk space. Such features can also be deactivated manually, see Deactivating Experimental Docker Features.

Hyper-V is Microsoft's hardware virtualization product which lets you create and run a software version of a computer, called a virtual machine. For Hyper-V, you have to activate Hyper-V and Containers Windows features. Using Hyper-V can negatively affect system performance.

Hyper-V System Performance Disclaimer

If Hyper-V is enabled in Windows, be aware that this might affect the overall PC system performance and, therefore, could lead to longer processing times or to reduced acquisition performance in the software. Enabling the BIOS level hardware virtualization does not influence the system performance and can be left switched on.

Hardware Recommendations:

  • ZEISS MidRange Workstation
  • 64 GB RAM or more (32 RAM dedicated to Docker Desktop)
  • For the use of AI models the recommended hardware configuration is 8GB GPU and 64GB RAM. Only NVIDIA GPUs and the CPU are supported.

Defining Docker Startup and Docker Image Location

  1. Docker is running on your PC.
  1. Open Docker Desktop and go to the settings.
  2. The settings are displayed.
  3. To start Docker Desktop on Windows startup, go to the General tab and activate Start Docker Desktop when you sign in to your computer. If you do not want to start Docker automatically on system startup, make sure the option is deactivated.
  4. The startup setting is defined.
  5. In the menu on the left, click Resources > Advanced.
  6. Resource options are displayed.
  7. For Disk image location, click Browse.
  8. A file browser opens.
  9. Go to the folder where you want to place the Docker images, and click Select Folder.
  10. The path is defined.
  11. Click Apply & restart.
  12. The settings are applied.

Adapting the Resource Allocation for Docker Desktop Manually

If you do not use WSL2, the resources allocated to docker are not managed by Windows and might not be big enough in certain instances. In such a case, you can adapt the resources manually in Docker.

  1. Docker is running on your PC.
  1. Open Docker Desktop and go to the settings.
  2. The settings are displayed.
  3. In the menu on the left, click Resources.
  4. The Advanced tab displays options for resource allocation on the right.
  5. Adapt the resources with the individual sliders.
  6. The resource allocation is defined.
  7. Under Resources, click File sharing.
  8. The option for file sharing is displayed on the right.
  9. Enter any local path that should be shared with the containers.
  10. Click Apply & restart.
  11. The settings are applied.

Deactivating Experimental Docker Features

  1. Docker is running on your PC.
  1. Open Docker Desktop and go to the settings.
  2. In the menu on the left, click Features in development.
  3. Click Experimental features.
  4. The tab displays currently available experimental features.
  5. Deactivate the feature(s) and click Apply & restart.

Compatible Cameras

The table below displays which cameras are compatible to the software.

Compatible ZEISS Axiocams

Camera

Connection

Axiocam 105 color

USB 3.0

Axiocam 202 mono

USB 3.0

Axiocam 203 mono

USB 3.0

Axiocam 208 color

USB 3.0

Axiocam 212 color

USB 3.0

Axiocam 305 color / mono

USB 3.0

Axiocam 503 color / mono

USB 3.0

Axiocam 506 color / mono

USB 3.0

Axiocam 512 color / mono

USB 3.0

Axiocam 702 mono

USB 3.0

Axiocam 705 color / mono

USB 3.0

Axiocam 712 color / mono

USB 3.0

Axiocam 807 color / mono

2x USB 3.0

Axiocam 820 color / mono

2x USB 3.0

Compatibility of Windows Versions to Machine Learning and AI Features

ZEN core allows you to use certain machine learning and AI functionality, e.g. semantic segmentation and denoising (via the respective Intellesis functionality) as well as the use of AI models for instance segmentation.

The following table illustrates CPU and GPU usage for ZEN Toolkit AI, ZEN Toolkit 2D, and ZEN Toolkit Material Apps:

Windows 10 version 1607 (build 14393), e.g. Windows 10 Enterprise LTSB 2016

Windows 10 version 1809 (build 17763), e.g. Windows 10 Enterprise LTSC 2019

Windows 10 version 21H2 (build 19044), e.g. Windows 10 Enterprise LTSC 2021

Windows 11, version 24H2 (build 26100), e.g. Windows 11 Enterprise LTSC 2024

ZEN Toolkit AI

CPU fallback for semantic segmentation and denoising.

Additional GPU support for semantic segmentation and denoising.

ZEN Toolkit 2D

ZEN Toolkit Material Apps

CPU fallback for semantic segmentation.

Additional GPU support for semantic segmentation and instance segmentation using CPU.

Additional GPU support for instance segmentation.

When using instance segmentation models trained on arivis Cloud for image segmentation in ZEN Toolkit 2D or ZEN Toolkit Material Apps, an installation of Docker is necessary. Depending on your Windows and Docker version, the functionality can be limited to only run on CPU instead of GPU. The following tables illustrate which Docker and operating system version you need if you want to use the functionality also with GPU, and if you need to use Hyper-V or WSL.

To install Docker Desktop, you can use the ZEISS Microscopy Installer, with the exception of older Windows versions, for which you need to install an older version of Docker Desktop directly from the Docker website, see table below.

Windows 10 version 1607 (build 14393), e.g. Windows 10 Enterprise LTSB 2016

Windows 10 version 1809 (build 17763), e.g. Windows 10 Enterprise LTSC 2019

Windows 10 version 21H2 (build 19044), e.g. Windows 10 Enterprise LTSC 2021

Windows 11, version 24H2 (build 26100), e.g. Windows 11 Enterprise LTSC 2024

Docker version for instance segmentation

not supported

Version ≤ 4.24.2
For version 4.24.1, use https://desktop.docker.com/win/main/amd64/123237/Docker%20Desktop%20Installer.exe

Current version available with the ZEISS Microscopy Installer

WSL/Hyper-V

not supported

Hyper-V

WSL 2

ZEN Toolkit 2D

No instance segmentation possible.

Instance segmentation using CPU.

Additional GPU support for instance segmentation.

ZEN Toolkit Material Apps

No instance segmentation possible.

Instance segmentation using CPU.

Additional GPU support for instance segmentation.

Changes to the Operating System

NOTICE

notice

Installation of software, hardware drivers, changes to operating system settings or other system interference beyond the actions needed to operate the software are always in the responsibility of the customer, because the potential impact cannot be estimated.

The following modifications have, in our experience, no effects on the functionality of the PC system:

  • Network integration
  • Installation of security software/antivirus software (highly recommend if your PC is attached to a network)
  • Logon as Domain Users in an Active Directory environment (possibly with local administrator privileges if user needs to install software)
  • Installation of standard software (e.g. Microsoft Office)
  • Installation of printers
  • Windows automatic updates and third-party software updates (Windows Service Packs are to be considered different)
  • Information about allowed Windows service packs can be found in the corresponding system requirements for Windows.

Effects of following modifications cannot be estimated:

  • Modifications in the Windows operating system
  • Implementation of group policies and scripts
  • Installation of third-party software with hardware support
  • Installation of third-party software for generating large data rates (such as backup software) due to possible performance problems of the simultaneous operation of Fast Acquisition Systems
  • Storage of data on network drives by redirecting folder structures (e.g. there can occur performance problems in case of Fast Acquisition systems or limitation of the available data storage capacity (disk quota))

If problems occur, the system can be restored to the state of delivery by a ZEISS service technician.

Configuration of Security Software

The following section explains how to properly configure your security software for installation and optimum operation of the software.

The term security software combines all programs which protect your computer from viruses, unwanted interventions, etc.. This includes virus scanners, firewalls and intrusion detection systems. If you do not adapt the security settings there can be problems while installing or running the software. The following topics will show you how to avoid problems with the security software and adapt the settings correctly.

Before Installation

To ensure correct installation, we recommend to perform the following settings:

  • Restore point
  • Set a restore point for the possibility to roll back the system in the case problems occur. It also is possible to ask the local ZEISS support team to create an image of the main drive of the PC before the security software is installed and setup by the customers IT department.
  • Lower security rules
  • Set the security rules from 'high' to 'low'. Refer to the respective operating instructions of your security software on how to set the security rules.
  • Disable security software
  • In rare cases, you may need to disable the security software completely. Make sure that you enable the security software after installation. Refer to the respective operating instructions of your security software on whether to enable or disable the security software.

After Installation

To ensure the optimal operation on Windows, we recommend you to perform the following settings after the installation:

  • Exclude program files from virus scanning
  • Exclude the following files from virus scanning. Refer to the respective operating instructions of your security software on how to exclude files from virus scanning.
    • ZENCore.exe
    • ZENService.exe
    • ZISProtocolServer.exe
    • MTBconfig.exe
    • Configuration tool.exe
    • AimApplication.exe
    • CZCanCheck.exe
    • CZCansrv.exe
    • System_Maintenance_Tool.exe
  • Exclude specific file extensions from virus scanning
    Exclude files with the following file extensions from virus scanning. Refer to the respective operating instructions of your security software on how to exclude file extensions from virus scanning.
    • *.czi
    • *.zvi
    • *.zishm
    • *.lsm
    • *.zmbi
  • Exclude ZEN core specific folders from virus scanning
    Under ? > About ZEN core > Show ZEN core Information > Folders you can see the program specific folders for ZEN core. Refer to the respective operating instructions of your security software on how to exclude folders from virus scanning.

Default Folders

Captured images are stored by default in the following folders:

Operating system

Folder / path

Windows 11

Pictures and

%USERPROFILE%\Pictures and

C:\Users\{user name}\Pictures

Change default archive and sandbox locations

See ZEN core > Maintenance > Archive Options to set paths to locations where data is stored/temporarily held.

Change default folder for images on your operating system

See in Windows 11 in the context menu of Pictures.

Summary

To ensure correct operation of the software it is necessary to ensure that the security software on your computer is not blocking the program. For full functionality you should have made ​​the following settings:

  • You have disabled the security software during installation or reduced the security settings.
  • You have excluded the entire application, the defined paths or relevant files from virus scanning.

 

Installing Basler Pylon (for Visioner systems)

Installing TCA with two digital cameras mounted to a manual dual adapter

The following instruction helps setting up the tiles region acquisition with the Axiocam 705 pol using both cameras.

The dual-camera support for TCA is approved for the following combination of digital cameras: Axiocam 705 pol and Axiocam 305 color or Axiocam 705 color.

The image orientation must be harmonized for both cameras to ensure the correct setting for tiles region acquisition and the correct lateral alignment of the particles. The settings are dependent on the microscope hardware and the MTB configuration of the stage.

  1. Attach the Axiocam 705 pol on top and the Axiocam 305 color / 705 color on the side of the dual adapter.
  2. Add both digital cameras to one MTB configuration.
  3. Rotate the Axiocam 705 pol and the digital color camera on the corresponding C-mount adapter to achieve for each a parallel camera-to-stage orientation.
  4. Select the Axiocam 705 pol in Maintenance > Select Active Camera or via the Select Camera tool in any of the acquisition workbenches.
  5. Define in Free Mode a manual scaling for Axiocam 705 pol, for all objectives and if zoom objectives are available, in addition for a minimum of 5 zoom magnification levels.
  6. Select, if required, the correct image rotation for Axiocam 705 pol in 2D-Acquisition > Extended Camera > Model Specific > General > Orientation for correct tiles region acquisition without stitching.
  7. For the validation define a tiles region with the large cross in the center of the particle test slide and acquire a small tiles region to verify correct tiles image acquisition without stitching.
  8. Select the digital color camera in Maintenance > Select Active Camera or via the Select Camera tool in any of the acquisition workbenches.
  9. Define a manual scaling for the digital color camera, for all objectives and if zoom objectives are available, in addition for a minimum of 5 zoom magnification levels.
  10. Adjust the image rotation for the digital color camera in 2D-Acquisition > Extended Camera > Model Specific > General > Orientation so that in camera live mode a centered particle or object has the same orientation independent which camera is selected.
  11. To align the zoom factor for Axiocam 705 color and Axiocam 705 pol, change the default setting for Axiocam 705 color in Extended Camera > Mode section > Live Speed drop down list to High Res.

Creating a Desktop Shortcut to Start a Specific ZEN core (EM) Profile

If you want to have the possibility to start ZEN core directly with a certain profile, you can create a specific desktop shortcut.

  1. You have installed ZEN core.
  1. Open the Windows file explorer and navigate to the folder where ZEN core is installed. The default is C:\Program Files\Carl Zeiss\ZEN core.
  2. Right click ZENcore.exe and drag and drop it to the desktop with pressed right mouse click.
  3. A context menu is displayed.
  4. Select Create shortcuts here.
  5. A shortcut is created on the desktop.
  6. Right click on the shortcut and select Properties from the context menu.
  7. The properties window is displayed.
  8. On the Shortcut tab, go to Target.
  9. The path of the exe file is displayed, e.g. C:\Program Files\Carl Zeiss\ZEN core\ZENcore.exe
  10. Change this path by adding a space, /ProfileId= and the respective ID of the profile. For information, see the table below.
  11. The path is changed, e.g. to C:\Program Files\Carl Zeiss\ZEN core\ZENcore.exe /ProfileId=ZenCore.LM.Starter.
  12. Click OK.
  13. The properties window closes and the changes are saved.
  1. You have created a shortcut for a specific profile of ZEN core. Starting the software by clicking this shortcut directly starts the respective profile.

Profile IDs for ZEN core & ZEN core EM

Profile

Profile ID

ZEN analyzer

ZenCore.LM.Analysis

ZEN core

ZenCore.LM.Core

ZEN core SEM

ZenCore.LM.SEM

ZEN core starter

ZenCore.LM.Starter

ZEN core Visioner

ZenCore.LM.Visioner

Crossbeam

Crossbeam

EVO

EVO

FE-SEM

FE-SEM

Volutome

Volutome

Troubleshooting

This chapter contains information on how to tackle common problems.

Fixing runtime or compatibility issues for externally trained neural networks

In case you run into import or runtime issues in the context of externally trained neural networks, go to https://pypi.org/project/czmodel/ for information on model and compatibility requirements.

Impressum
Carl-Zeiss-Strasse 22
73447 Oberkochen
Germany
Legal