In ProcessMaker a workspace allows a group of processes and their cases to be managed as a cohesive unit. The data for each workspace is stored in one database in MySQL and its files are located in a separate directory, so there is no contamination of data between workspaces. Because the data is in separate databases and directories, workspaces can be separately backed up and restored.

Workspaces allow complex organizations to divide up their processes and users into separate groupings for easier data management. For example, the Human Resources, Accounting and Sales departments might all have their own separate workspaces which are accessed by different sets of users.

Businesses which offer ProcessMaker as a hosted service can create a separate workspace for each of its clients. The Enterprise Edition facilitates the hosting of workspaces by providing a user-friendly Multitenant Workspace Management, where workspaces can be easily managed with options to create, enable, clone, restore, backup, enable and disable workspaces, view statistics about multiple workspaces at a glance.

Creating Workspaces

The "workflow" workspace is create by default when ProcessMaker is first installed. This workspace is specified inside the URL when accessing ProcessMaker through a web browser:

Additional workspaces can be added either by changing the URL in the web browser in the Community Edition or through the Multitenant Workspace Management in the Enterprise Edition.

Creating Workspaces in the Community Edition

Login to ProcessMaker with a user who has the PM_SETUP_ADVANCE permission in their role. Then, edit the web browser URL to access the form to create a new workspace:


Replace <IP-ADDRESS>:<PORT> and <CURRENT-WORKSPACE> for your setup. For instance, if currently running ProcessMaker on a server at on the default port 80 in the default workspace named "workflow", then use the address:

Then fill out the New Workspace form.

New Workspace Form

In the form which appears, enter information about the new workspace.

New Workspace

  • Name: The name of the new workspace, which can contain a maximum of 13 characters. From version 3.1.3 on, the maximum length has been increased to 30 characters.

Database Options: The workspace data will be created just in one database:

  • Workflow Database: The name of the database which will hold data about processes, cases, users, PM Tables, etc.
  • Drop database if exists: Check this option to delete any existing databases with the same name as the specified in the Name field. Note that in most cases, it is not recommended to check this option, any existing data won't be recoverable.

Workspace Administrator: Define the credentials of the administrator user for the workspace that will be created. This user will have the "PROCESSMAKER_ADMIN" role by default.

  • Username: The username for the administrator of the new workspace. By default, the username is "admin".
  • Password: The password of the administrator of the new workspace. The password must be entered twice to avoid careless typos. By default, the password is "admin".

After filling out the form, click on Test to check whether the entered values are valid and don't conflict with the names of existing MySQL databases. If there are no conflicts with any existing site, a message window will open asking if the new site should be created. Click Yes to create the new site, or click No to close the window and return to the form.

ProcessMaker will begin to create the new workspace. Once done, a new message dialog will be displayed. To be redirected to the login screen of the new workspace, click on Yes.

To stay in the New Workspace form, click on No. Then, use the web browser's back button (or ALT+BACKARROW) to return to the previous page.

Switching Workspaces

After the new workspace has been created, access to the new workspace at any time by changing the URL in the web browser.

Setting a Default Workspace

If only one ProcessMaker workspace is being used, it may be a good idea to add that workspace to the URL to make it the default workspace. If a default workspace is set, after entering the domain (e.g., the system reads the configuration and redirects to the default workspace (e.g.

To set a default workspace, edit the file index.html with a plain text editor. The index.html file is generally found at the following location:


Add the workspace name in line 6 of the code:

<html> <head> <title>Redirector</title> <meta http-equiv="PRAGMA" content="NO-CACHE" /> <meta http-equiv="CACHE-CONTROL" content="NO-STORE" /> <meta http-equiv="REFRESH" content="0;URL=sysworkspace/en/neoclassic/login/login" /> </head> </html>

For example, if the default "workflow" workspace is being used, this line will look like:

<meta http-equiv="REFRESH" content="0;URL=/sysworkflow/es/green/login/login.html" />

Warning: These changes to the source code will be overwritten each time ProcessMaker is upgraded, or when the system properties are modified, so they will have to be reapplied after each upgrade or setup modification.