This section describes the possible deployment strategies.

this section is a subject to change

Continuous Integration Server

The Continuous Integration Server does a publish in a directory structure. This directory structure is transformed by a fetch script into the designated directory structure.

It’s not recommended to use the Continuous Integration Servers structure directly. The next section will discuss the fetching process and the designated directory structure.

Fetching and Destination Directory Structure

The fetching script is responsible for

The directory structure on the deployment server should look like this:

Root Directory

The deployment script, responsible for upgrading the servers database

The fetch script, responsible for creating the directory structure and fetching all assemblies and configuration templates


This directory contains all app configuration files needed by the executing assemblies. E.g. in the Zetbox.Server.Service.exe.config all WCF Service stuff can be configured. In Zetbox.Client.WPF.exe.config all WCF Proxy stuff can be configured.

The fetch script will copy those configuration files into the desired directories, right beside their executalables.

So this is the place where all app specific configuration has to be defined.

Besides WCF stuff, those configuration can be also found in those files:

The web.config is not located here, but this may change in the future


This directory contains all Zetbox configuration files. They are located by the executalable by probing


The bin directory contains all assemblies used by Zetbox, divided by theire use (Bootstrapper, Client or Server). The Client and Server directories contains sub directories to split Client/Server and Common parts. Those directories have for each Application (=Zetbox Module) and Modules (not Zetbox Modules!) a individual sub directory.

The naming of Application (=Zetbox Module) should be:


Core contains all core assemblies like Zetbox.API and all other assemblies that are referenced by default (log4net e.g.).

Core.Generated contains all genereated code. Code Generation is done by the Continuous Integration Server so those assemblies will be copied by the fetch script.

This is a topic of discussion

Bootstrapper contains only one executalable. The Boostrapper itself which is downloading the whole client application with its configuration from an HTTP Server via REST.

Deployment on a Linux Server

On Linux the following packages are needed:

Apache configuration

The Apache Server is responsible for authentication. The ZToolbox server trusts Apache and uses the passed identity (through the HTTP Header).

Deployment on a Windows Server

Setting up security

Two major things has to be configured


A Identity Source syncs one source with zetbox Identites. It's not necessary, to have one. You can edit the Identites in zetbox directly.