Skip to main content

ClassCAD Server


ClassCAD application file (ccapp)#

Regardless of the host platform you use, you need the ClassCAD application package, the so-called class file (ccapp). This file contains the ClassCAD business logic. Without it you will not be able to start the ClassCAD server.

Go to the member area on this page and register, if you have not already done so. After registering/logging in, you will be able to access the download area.

โš ๏ธ The ccapp file contains personalised data and should therefore be treated confidentially. Please do not include it in the version management and do not pass it on to third parties.

Node and npm#

  • To install the ClassCAD binaries, npm must be installed.
  • To be able to run the server afterwards, node.js is required.


The following system properties should be fulfilled in order for the server to operate properly.

  • >20GB disk space, ClassCAD requires disk memory for local, temporary states.
  • >2GB of memory per ClassCAD Instance
  • 1 CPU Core per ClassCAD Instance


By running the following commands in a directory of your choice the required windows binaries will be installed. Make sure your console window points to the intended working directory.

npm init -y
npm i @classcad/windows-x64

To test the installation please execute the following command in a terminal window and you should see the help message. The current working directory needs to be the root of your package.

npx classcad --help

Now, you're ready to start the ClassCAD Server. Make sure to provide the proper ccapp package path to the --ccappfile option. The path can be either relative to the package root or absolute.

npx classcad --ip localhost --port 8182 --instances 5 --ccappfile <PATH-TO-CCAPP-FILE>.ccapp

Check the status of the ClassCAD server.


That's it, now you can connect your first client to the Windows server.


We recommend using Docker to set up the server on Linux. If you still want to install ClassCAD directly on a Linux machine, please follow the instructions below.

Ubuntu 18.04


Ubuntu 20.04


Mac OS#

Apple operating systems are not supported.

๐Ÿ“ Note: You can try to run the server on Apple operating systems via Docker. However, this has not been tested and the behaviour is therefore unknown.


The following dockerfile gives you instructions about all steps needed to get a running ClassCAD server on Ubuntu:18.04.

Dockerfile Ubuntu 18.04
FROM ubuntu:18.04
# Install linux dependencies
RUN apt-get update && apt-get install -y \
libicu60 \
libglu1-mesa-dev \
ocl-icd-opencl-dev \
# Language settings
# Install node and npm
RUN apt-get install -y curl
RUN curl -sL | bash
RUN apt-get install -y nodejs
# Install ClassCAD
ENV CC_DIR /classcad
RUN mkdir -p $CC_DIR
RUN npm init -y
RUN npm i @classcad/linux-x64
RUN chmod +x ./node_modules/@classcad/linux-x64/ClassCADInstance
# Copy runtimes to libs
RUN cp ./node_modules/@classcad/linux-x64/ /lib/x86_64-linux-gnu
# Copy the .ccapp downloaded from
# Replace <PATH-TO-CCAPP-FILE> with the path pointing to the downloaded .ccapp file.
COPY <PATH-TO-CCAPP-FILE>.ccapp modeling.ccapp
# Start the server
EXPOSE 8182/tcp
CMD npx classcad --ip --port 8182 --instances 5 --ccappfile modeling.ccapp
  • Please do not forget to replace PATH-TO-CCAPP-FILE with the path to your downloaded class file.
  • Please do not forget to bind the port when starting the docker container

After starting a docker container with the docker file from above, the ClassCAD server should be online. Check the status of the ClassCAD server.


That's it, now you can connect your first client to the docker container server.