Project and database server setup

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Bizagi Studio installation > Teamwork setup on-premises > Teamwork setup using Bizagi Studio >

Project and database server setup


To setup your project and database server, you need to follow a series of setups described in this section.


Before you start

You will first need to define:

The database server having a SQL Server or Oracle instance installed. refer to Database server requisites for further information.

The server to be the project server, hosting the Bizagi project.

oIt is recommended to use a different dedicated server to host your Bizagi project, though you may use the same Database server to use Bizagi Studio and host your Bizagi project according to the characteristics of your implementation.

The users that will work on the project, by connecting from their workstations to the central server.


What you need to do

For a teamwork collaboration setup, follow these steps:

1. Install the database server

2. Install the IIS in the project server

3. Install Bizagi Studio in the project server.

4. Create the Bizagi project at the project server

5. Include authorization entries at the project server for your users

6. Setup the process developers workstations


1.  Install the database server

First you need to install a database server where the collaborative project's database is going to be stored.  See the database requisites.


You can choose either SQL or Oracle. The database server can be installed in the same physical central server, or in a separated server. We recommend, if possible, to use a separate database server, so you can perform maintenance and security task easily for each server.


Make sure you have the following features checked:



Feature or element to install



Install a database engine


see Database prerequisites

Install a database engine

SQL Server instance

Set up the collation

Use case-insensitive (CI), not a turkish collation. We recommend SQL_Latin1_General_CP1_CI_AS

enable TCP/IP for the database instance


Define authorized login accounts. See Advanced configuration of SQL login accounts.

Define the security of the SQL logins.


2.Install the IIS in the central server

The Work Portal is a web-based application that must be run in the Internet Information Services (IIS). Review the IIS configuration.


For the IIS to work you need to activate the following Windows Features:



Feature or element to install


Install the web server (IIS), turning the following windows features on


See Bizagi server requisites

Web management tool

IIS  Management compatability

IIS management console

IIS metabase and IIS configuration compatability

IIS Management console

IIS Management scripts and tools

IIS Management service

World wide web services

Application development

.NET Extensibility 3.5

.NET Extensibility 4.6




ISAPI Extensions

ISAPI Filters

Common HTTP features

Default document

Directory browsing

HTTP Errors

Static Content

Performance features

Dynamic content compression

Static content compression


Basic authentication

Request filtering

Windows authentication

IP and domain restrictions


3.Install Bizagi Studio at the project server

Install Bizagi Studio by running the installer with administration rights at the project server.

Carry out the installation steps described at Quick start setup, but this time you may skip the option to install a bundled SQL Server instance and use the corporate instance of your database server.


The SQL credentials will be used from the different workstations connecting to the central server. Make sure that the SQL connection string used is one that workstations can resolve. It can be a Fully Qualified Domain Name (FQDN) .


You may verify access to your database if you will be using a SQL Server instance:




4. Create the Bizagi project in the project server.

Upon a completed installation, create a new Bizagi project in the central server, as described at Creating a new project.

Recall that in order to create a Bizagi project, you need a server admin account.


If you already have some progress on an existing project, it is best that you create a new project at this server.

Then, you may easily import your progress by creating a backup of your existing project's database, and restoring this backup into the new project's database. See how to restore a backup of your Bizagi database.



If you are using a SQL Server database, and you are relying on advanced configuration of SQL Server login accounts, make sure you create the project by specifying the use of an authorized login account.

You will need a Process administrator login account or an account with higher privileges, as described at Advanced configuration of SQL Server login accounts.


5. Include authorization entries at the project server for your users

At the project server, make sure you add as users all project developers' accounts into the Bizagi Administrators group.

Notice that this group is created automatically by Bizagi's installation and by default, only the server administrator is included.


The Bizagi Administrators group is a Windows users group that has the following characteristics:


The purpose of this group is to provide governance over Bizagi Studio and the Management Console as desktop applications in the server.

Users of this group have standard permissions. Therefore, permissions at the server, features, or services level are not included.

Users included within the Bizagi Administrators group can access Bizagi Studio or the Management Console. This validation assure that other users of your server have no access to your Bizagi development environment.

Users included in this group can perform administrative tasks such as: create new projects, delete projects, upgrade projects, or select a webserver. Therefore, the Bizagi Administrators group acts as a security measure to control your development environment.


To add users or active directory groups into this group (Bizagi), browse the local management options to locate the local user and groups item.

Right-click on the Bizagi group to use the Add to group.. option:




Then choose specific users or active directory groups which will be authorized to open the project:





You may also rely on Bizagi Studio security feature, in order to define authorization options of who can work in which processes.

For more information about this option, refer to Bizagi Studio security.

Bizagi allows you to add individual users or active directory groups.


Technical requirements

The following technical requirements are applicable between different endpoints.







Developer workstations using Bizagi Studio and the Development server using Bizagi Studio.


As defined by your database's instance service (e.g, 1433 by default for SQL Server, 1521 by default for Oracle).

Developer workstations using Bizagi Studio and the Database server. This connection is performed using encryption

The Development server using Bizagi Studio and the Database server.


Usually port 80 for HTTP (or port 443 for HTTPS)

Developer workstations using Bizagi Studio and the Development server using Bizagi Studio.


Users connecting to the created project to work on the implementation do not need administrator rights but an authorized entry at the Bizagi group.


The next step is setup the process developers workstations.