---
description: >-
  This guide will instruct you on how to get started with ProcessMaker, from
  local installs to rapid cloud deployment.
---

# Installing ProcessMaker

<details>

<summary><mark style="background-color:purple;">System Requirements</mark></summary>

## System Requirements

See these on-premises server requirements prior to installing the ProcessMaker Platform open-source edition on-premises.

ProcessMaker Platform Spring 2024 has the following system requirements:

* [Laravel framework version 8](https://laravel.com/docs/8.x/releases)
* MySQL 8.0
* PHP 8.1 or later

</details>

{% tabs %}
{% tab title="Docker for Local Development" %}
## Overview

Install the open-source ProcessMaker Platform using [Docker Desktop](https://www.docker.com/products/docker-desktop/) and [Docker Compose](https://docs.docker.com/compose/). Before proceeding with the installation process, it is essential to have a basic understanding of Linux commands. Familiarity with common command-line operations such as navigating directories, executing commands, and editing files will greatly facilitate the installation process and troubleshooting.

## Requirements

Before proceeding with the installation, ensure that you have met the following prerequisites.

<table data-full-width="false"><thead><tr><th>Requirement</th><th width="234">Function</th><th width="94">Version</th><th>Installation Guide</th></tr></thead><tbody><tr><td><a href="https://learn.microsoft.com/en-us/windows/wsl/install">WSL2</a> or Unix based OS</td><td>WSL2 enables access to the command line for installing and accessing containers.</td><td>Latest</td><td><a href="https://learn.microsoft.com/en-us/windows/wsl/install">Setting up WSL2</a></td></tr><tr><td><a href="https://www.docker.com/products/docker-desktop/">Docker</a></td><td>Docker provides the underlying technology to deploy containerized applications.</td><td>Latest</td><td><a href="https://docs.docker.com/get-docker/">Setting up Docker</a></td></tr></tbody></table>

### WSL2 (Windows Subsystem for Linux)

If you are using Microsoft Windows, then you can install ProcessMaker within WSL2.

Go to [Microsoft's site](https://learn.microsoft.com/en-us/windows/wsl/install) and follow their instructions. It's very easy and quick.

### Docker

Download and install [Docker for Desktop](https://www.docker.com/products/docker-desktop/).

{% hint style="success" %}
If you are on Microsoft Windows, ensure to go into settings and enable the WSL2 integration.
{% endhint %}

## Docker Compose

This installation procedure uses Docker Compose. The Docker Compose file is located in this [GitHub repository](https://github.com/ProcessMaker/pmcore-docker). Issues, PRs and contribution are most welcome!

### The Docker Compose File

{% hint style="danger" %}
Ensure you specify which branch or release of the ProcessMaker repository you wish to install and replace `${PROCESSMAKER_CORE_VERSION_INSTALL}` with the desired version.
{% endhint %}

Open up your terminal for your platform:

* **Windows:** Windows Terminal is a good option. Just make sure you don't go into CMD or PowerShell.
* **Macs:** iTerm is a good option.
* **Other Unix-based operating systems:** The native terminal should be more than adequate.

{% hint style="success" %}
Oh My Zsh is a wonderful CLI tool that can help you with auto-completion within the terminal and syntax highlighting, convenience methods and much more.

You can find information about [installing it here.](https://ohmyz.sh/)
{% endhint %}

The yaml file below is the `docker-compose.yaml` file that we are going to use.

{% code overflow="wrap" fullWidth="false" %}
```yaml
version: '3.3'
networks:
    processmaker:
volumes:
    docker-data:
    redis-data:
services:
    mysql:
        image: mysql:8
        platform: linux/amd64
        ports:
            - '3306:3306'
        security_opt:
            - seccomp:unconfined
        environment:
            MYSQL_ROOT_PASSWORD: C0mpliCat3dPassW0rd
            MYSQL_DATABASE: pm4
            MYSQL_USER: pm4_user
            MYSQL_PASSWORD: pm4_password
        networks:
            - processmaker
        volumes:
            - ./mysql-data:/var/lib/mysql
        restart: always
        healthcheck:
            test: [ 'CMD', 'mysqladmin', 'ping', '-u', 'root', '-p${MYSQL_ROOT_PASSWORD}' ]
            interval: 30s
            timeout: 10s
            retries: 5
    phpmyadmin:
        depends_on:
            - mysql
        image: phpmyadmin/phpmyadmin
        environment:
            PMA_HOST: "mysql"
            PMA_ARBITRARY: 1
        ports:
            - '8080:80'
        networks:
            - processmaker
    redis:
        image: redis:6
        command: redis-server --save 60 1 --loglevel warning
        ports:
            - '6379:6379'
        networks:
            - processmaker
        volumes:
            - redis-data:/data
        restart: always
        healthcheck:
            test: [ 'CMD', 'redis-cli', 'ping' ]
            interval: 30s
            timeout: 10s
            retries: 5
    docker:
        image: docker:20-dind
        privileged: true
        ports:
            - '2375:2375'
        networks:
            - processmaker
        volumes:
            - docker-data:/var/lib/docker
            - ./scripts:/opt/scripts
        environment:
            DOCKER_DRIVER: "overlay2"
            DOCKER_TLS_CERTDIR: ""
        restart: always
        healthcheck:
            test: [ 'CMD', 'docker', 'info' ]
            interval: 30s
            timeout: 10s
            retries: 5
    processmaker:
        image: processmaker/pm4-dev:4.3v1
        ports:
            - '80:80'
            - '6001:6001'
        depends_on:
            mysql:
                condition: service_healthy
            redis:
                condition: service_healthy
            docker:
                condition: service_healthy
        networks:
            - processmaker
        volumes:
            - ./processmaker:/opt/processmaker
            - ./env:/opt/.env
            - ./scripts:/opt/scripts
        environment:
            PM_branch: ${PROCESSMAKER_CORE_VERSION_INSTAll}
            WAIT_FOR_DEPENDENTS: 1
            DOCKER_HOST: 'tcp://docker:2375'
            NO_PROXY: "127.0.0.1,localhost,docker:2375"

```
{% endcode %}

### The Laravel ENV File

Below is the default configuration parameters for the `.env` file (which will be `env` if cloning from the repo). You can copy-and-paste the snippet below into a new file. If you are using the repository, it should already be set there.

{% code overflow="wrap" fullWidth="false" %}
```
APP_URL=http://localhost
DOCKER_HOST_URL=https://localhost
BROADCASTER_HOST=http://localhost:6001
LARAVEL_ECHO_SERVER_AUTH_HOST=http://localhost
APP_KEY=base64:bCBJXXFbO/dgnlaJvQPLKWWE/dzhsn1+ylOS5vm9zxc=
APP_DEBUG=TRUE
DEBUGBAR_ENABLED=FALSE
APP_NAME=ProcessMaker
APP_ENV=local
DB_HOSTNAME=mysql
DB_DATABASE=pm4
DB_USERNAME=pm4_user
DB_PASSWORD=pm4_password
DB_PORT=3306
DATA_DB_DRIVER=mysql
DATA_DB_HOST=mysql
DATA_DB_DATABASE=pm4
DATA_DB_PORT=3306
DATA_DB_USERNAME=pm4_user
DATA_DB_PASSWORD=pm4_password
APP_TIMEZONE=UTC
DATE_FORMAT="m/d/Y H:i"
MAIN_LOGO_PATH="/img/processmaker_logo.png"
ICON_PATH_PATH="/img/processmaker_icon.png"
LOGIN_LOGO_PATH="img/processmaker_login.png"
CACHE_DRIVER=redis
BROADCAST_DRIVER=redis
REDIS_PORT=6379
REDIS_HOST=redis
HOME=/opt/processmaker
HORIZON_PREFIX=pm4:
BROADCASTER_KEY=21a795019957dde6bcd96142e05d4b10
LARAVEL_ECHO_SERVER_PORT=6001
LARAVEL_ECHO_SERVER_DEBUG=TRUE
LARAVEL_ECHO_SERVER_PROTO=http
LARAVEL_ECHO_SERVER_REDIS_HOST=redis
LARAVEL_ECHO_SERVER_REDIS_PORT=6379
DOCKER_HOST=tcp://docker:2375
PROCESSMAKER_SCRIPTS_DOCKER_HOST=tcp://docker:2375
PROCESSMAKER_SCRIPTS_HOME=/opt/scripts
API_SSL_VERIFY=0
PROXIES=*
LOGOUT_OTHER_DEVICES=false
BROWSER_CACHE=true
API_TIMEOUT=5000
SESSION_DRIVER=redis
SESSION_SECURE_COOKIE=false
```
{% endcode %}

You may change any settings that you wish. Just make sure that the settings are valid and do not cause errors or issues.

In your terminal, run the following Docker command inside the folder where your Docker Compose file is:

```
docker-compose up
```

To spin down the environment, run the following Docker command:

```
docker-compose down
```

{% hint style="warning" %}
If this is your first time installing, it will take time for all the Docker images to download. At the end, you should see a message in your terminal that shows the Laravel Echo server is running and initial jobs should start running.
{% endhint %}

## Did You Know?

The script adds a mounted folder for the ProcessMaker Platform installation and for Scripts, which is basically a good place to stick anything that is not purely ProcessMaker that you need as part of your application. For example, if you are developing a custom package or using Script Executors.

You may access the filesystem from outside the container. Just make sure to run any commands like `composer update` within the container (or send the command to it).

## Troubleshooting

{% hint style="info" %}
This section will be updated regularly as new issues and troubleshooting steps become known.
{% endhint %}

## Feedback

If you got all the way down here, congratulations on being thorough! If you could kindly rate this page as helpful or unhelpful, that goes a long way towards improving our content.

## Quick Start with Process Templates

Explore our ready-to-go Process Templates to kick-start your automation across several use cases and industries. Deploy into your Platform instance to spin up new processes and use as-is with all necessary assets included.

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><mark style="color:blue;"><strong>How to import Process Templates</strong></mark></td><td></td><td></td><td><a href="broken-reference">Broken file</a></td><td><a href="https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template">https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template</a></td></tr><tr><td align="center"><mark style="color:blue;"><strong>Download Process Templates</strong></mark></td><td></td><td></td><td><a href="broken-reference">Broken file</a></td><td><a href="https://www.processmaker.com/resources/customer-success/templates/">https://www.processmaker.com/resources/customer-success/templates/</a></td></tr></tbody></table>
{% endtab %}

{% tab title="Cloud Quick Start (Bitnami)" %}
## Overview

This guide will walk you through the steps to install and configure [ProcessMaker Community using Bitnami on Amazon AWS](https://bitnami.com/stack/processmaker/cloud/aws/amis) cloud platform. By following this guide, you will have a fully functional instance of ProcessMaker Community, a powerful, open-source business process management (BPM) and workflow software.

## Prerequisites

{% hint style="warning" %}
Please note that in order to set up a new instance, you will need an AWS account with sufficient permissions. It is important to ensure that your AWS account has the necessary privileges to create and configure instances, as well as manage associated resources.
{% endhint %}

| Requirement        | Function                                                                                                                                                           |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Amazon AWS Account | AWS provides a highly scalable and reliable infrastructure, allowing users to access on-demand computing resources, storage, databases, and other functionalities. |

### Step 1: Select the AWS Cloud Platform

Go to this link: [https://bitnami.com/stack/processmaker/cloud/aws/amis](https://bitnami.com/stack/processmaker/cloud/aws/amis)

Select the region where you wish to host ProcessMaker and initiate the deployment process.&#x20;

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FDtzNG8bRExEiODdDoxzq%2Fimage.png?alt=media&#x26;token=b0f82cd3-3678-4869-aff6-520f02ad3b94" alt=""><figcaption><p>AWS Region to launch an instance</p></figcaption></figure>

### Step 2: Configure your Instance

1.  Specify the desired name for your instance, as illustrated in the example below. This name will help you easily identify and manage your instance within your cloud platform environment.

    <figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FybMbMO8qxXIhFBdLyzwZ%2Fimage.png?alt=media&#x26;token=5c6e0e09-d0f5-4745-b94b-b7bd9ec47ea0" alt=""><figcaption><p>Define name and tags</p></figcaption></figure>
2. Choose the appropriate instance type that best suits your needs.&#x20;

{% hint style="info" %}
The instance type determines the computing resources allocated to your ProcessMaker installation, such as CPU, memory, and storage capacity. Carefully consider the requirements of your workload and select an instance type that provides optimal performance and scalability for your ProcessMaker deployment.
{% endhint %}

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2F01G6uZFv9WhN8tL1i8YS%2Fimage.png?alt=media&#x26;token=4c156bfd-776f-4f80-b5ce-44ef348ef8a8" alt=""><figcaption><p>Instance type</p></figcaption></figure>

3. Ensure the security of your instance by selecting a Key Pair that will allow you to establish secure connections. Choose an existing Key Pair or create a new one to establish a secure connection.

{% hint style="info" %}
A Key Pair consists of a public and private key, and it is essential for securely accessing and managing your instance.
{% endhint %}

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2F86uoGid6hGNUclb8SkeR%2Fimage.png?alt=media&#x26;token=0e30deae-a591-40b6-a551-2a55e8b2efb8" alt=""><figcaption><p>Key Pair</p></figcaption></figure>

4.  Configure the network settings for your ProcessMaker instance. Ensure that the network settings align with your desired networking environment and security requirements to enable seamless communication and access to your ProcessMaker instance.

    <figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FGWss2m7yEHXR8xyLsYqL%2Fimage.png?alt=media&#x26;token=8e08c700-5da6-4548-884f-6a33cd73f901" alt=""><figcaption><p>Network Settings</p></figcaption></figure>
5.  Choose your desired storage capacity.

    <figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FPwT05bDFRvRkvm6rplTZ%2Fimage.png?alt=media&#x26;token=8e90546c-db6e-4877-9d00-f264fee48949" alt=""><figcaption><p>Configure storage</p></figcaption></figure>
6.  Initiate the launch process for your instance. Click on the **Launch instance** button.\


    <div align="left"><figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2F7qFk9AD946AMP5sODbAb%2Fimage.png?alt=media&#x26;token=7c037689-405c-4f17-922c-1132c892683c" alt="" width="375"><figcaption></figcaption></figure></div>
7. After launching your instance, locate and click on the instance ID associated with your ProcessMaker deployment.&#x20;

{% hint style="info" %}
The instance ID serves as a unique identifier for your instance within your cloud platform's management console. By clicking on the instance ID, you can access detailed information and perform various management tasks, such as monitoring resource usage, adjusting configurations, and troubleshooting any potential issues related to your instance.
{% endhint %}

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FK2YcPcoSj1xfzafclTL4%2Fimage.png?alt=media&#x26;token=a1a7ef33-430d-45f3-8ca4-5dba45105b59" alt=""><figcaption></figcaption></figure>

Please allow a few minutes for the instance initialization process to complete. Once the Instance state transitions to "Running," it indicates that your ProcessMaker instance is ready for access.

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FbbzMYbckO1aNozGDldYC%2Fimage.png?alt=media&#x26;token=cd1bd6b4-6ea5-450f-a80a-f3cce79d9c72" alt=""><figcaption><p>Instance Running</p></figcaption></figure>

### Step 3: Retrieve your Credentials

1. Select your instance.
2. Navigate to the "Actions" menu and choose "Monitor and troubleshoot" or a similar option.
3. Look for the "Get system log" or a similar option within the available actions.
4. Click on "Get system log" to retrieve the system log information associated with your instance.&#x20;
5. Examine the logs to find your ProcessMaker login credentials. These credentials will enable you to securely log in and begin utilizing the functionalities of ProcessMaker.

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FsDQ6UqpImyIIZZE2ecex%2Fimage.png?alt=media&#x26;token=de3290b3-b192-4ca1-ba5b-0116adf8bdf2" alt=""><figcaption><p>Login Credentials</p></figcaption></figure>

### Step 4: Access your ProcessMaker Instance

Choose your instance from the list and locate the Public IPv4 DNS associated with it. Open the provided link in your web browser. You will be directed to the login page of your ProcessMaker instance. Enter your login credentials to gain access to ProcessMaker's interface and start taking advantage of the ProcessMaker capabilities.

{% hint style="info" %}
This Public IPv4 DNS serves as the unique address that can be used to access your ProcessMaker instance from the internet.
{% endhint %}

<figure><img src="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FcFgqIhX5x4V0eJGaJH2s%2Fimage.png?alt=media&#x26;token=0e17f7e5-e8bd-42b6-b274-970bb0c3930b" alt=""><figcaption><p>ProcessMaker Login Screen</p></figcaption></figure>

## Conclusion

### Quick Start with Process Templates

In conclusion, by following the steps above we successfully set up a ProcessMaker instance in the AWS cloud platform using Bitnami. With the setup complete, you can now fully leverage the robust capabilities of ProcessMaker to enhance your business processes and drive operational efficiency.

Explore our ready-to-go Process Templates to kick-start your automation across several use cases and industries. Deploy into your Platform instance to spin up new processes and use as-is with all necessary assets included.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><mark style="color:blue;">How to import Process Templates</mark></td><td></td><td></td><td><a href="https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template">https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template</a></td><td><a href="broken-reference">Broken file</a></td></tr><tr><td><mark style="color:blue;">Download Process Templates</mark></td><td></td><td></td><td><a href="https://www.processmaker.com/resources/customer-success/templates/">https://www.processmaker.com/resources/customer-success/templates/</a></td><td><a href="broken-reference">Broken file</a></td></tr></tbody></table>


{% endtab %}

{% tab title="Kubernetes for Production Deployment" %}
## Overview

This guide provides instructions to deploy ProcessMaker on a Kubernetes cluster using Helm. This tutorial assumes a basic familiarity with Kubernetes concepts and commands. It is recommended to have a good understanding of concepts such as pods, deployments, services, and ingress. This knowledge will be beneficial for troubleshooting and managing the deployed application.

## Prerequisites

Before proceeding with the installation, ensure that you have met the following prerequisites.&#x20;

{% hint style="info" %}
A running Kubernetes cluster: Ensure that you have a Kubernetes cluster set up and accessible. This can be a local development cluster, a cloud-based Kubernetes service, or any other Kubernetes environment of your choice.
{% endhint %}

<table data-full-width="false"><thead><tr><th width="152">Requirement</th><th width="328">Function</th><th width="101">Version</th><th>Installation Guide</th></tr></thead><tbody><tr><td>Kubernetes</td><td>Kubernetes is a container orchestration platform that manages the deployment, scaling, and management of containerized applications. </td><td>1.19+</td><td><a href="https://kubernetes.io/docs/tasks/tools/">Setting Up Kubernetes</a></td></tr><tr><td>Helm</td><td>Helm is a package manager for Kubernetes that simplifies the deployment and management of applications. It allows you to define and manage application charts, which encapsulate all the necessary resources and configurations for your application.</td><td>3.12.0+</td><td><a href="https://helm.sh/docs/intro/install/">Setting up Helm</a></td></tr></tbody></table>

Please follow the steps outlined below to successfully deploy ProcessMaker on your Kubernetes cluster.

## Repository Configuration

To begin, add the ProcessMaker chart repository to Helm by executing the following command:

```
helm repo add processmaker https://charts.processmaker.io
```

This command ensures that you can access the ProcessMaker chart for installation.

## Update Repository

Update the list of repositories to fetch the latest charts:

```shell
helm repo update
```

## Install ProcessMaker on the Kubernetes Cluster

The following command deploys ProcessMaker on the Kubernetes cluster in the default configuration. The Parameters section lists the parameters that can be configured during installation.

```shell
helm install my-app processmaker/processmaker --set appConfig.host=my-app.example.com
```

This command deploys ProcessMaker on your Kubernetes cluster with the release name <`my-app>.` Replace \<m`y-app>` with a name of your choice. Also, set the `appConfig.host` parameter to your desired application host URL, such as `my-app.example.com.`

## Verify the Installation

After the installation, you can verify the deployment by listing all releases using the following command:

```shell
helm list
```

This command displays a list of all Helm releases, including the ProcessMaker release you just installed.

## Uninstall the ProcessMaker Deployment

If you need to uninstall or delete the ProcessMaker deployment, use the following command:

```shell
helm delete my-app
```

This command removes all the Kubernetes components associated with the ProcessMaker chart and deletes the release.

## Additional Configuration Options

The ProcessMaker chart provides various configuration options that you can customize during the installation. To explore all configurable options along with detailed descriptions, you have the following options:

1. **Review the `values.yaml` file:** You can inspect the chart's `values.yaml` file, which contains all the available configuration options and their default values.
2. **Use the `helm show values` command:** Run the following command to view the configurable options with their descriptions:

```
helm show values processmaker/processmaker
```

This command displays a detailed list of configuration options that can be customized during the installation.

{% hint style="info" %}
For further insights into the `values.yaml` file, we recommend exploring the following resources to deepen your understanding. [Configuration Values](https://artifacthub.io/packages/helm/processmaker/processmaker)
{% endhint %}

## Conclusion

In conclusion, this guide offers a step-by-step approach to installing ProcessMaker on Kubernetes using Helm. By following the instructions outlined in this guide, users can quickly and efficiently set up ProcessMaker, leveraging the power and flexibility of Kubernetes orchestration.

## Quick Start with Process Templates

Explore our ready-to-go Process Templates to kick-start your automation across several use cases and industries. Deploy into your Platform instance to spin up new processes and use as-is with all necessary assets included.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><mark style="color:blue;">How to import Process Templates</mark></td><td></td><td></td><td><a href="https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template">https://processmaker.gitbook.io/processmaker/designing-processes/viewing-processes/manage-process-templates/import-and-configure-a-process-template</a></td><td><a href="https://1243566085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPyTHGwZ0VereJkRNmGxE%2Fuploads%2FX4SdfUpHQHOA2ojzFHkf%2Fprocess.png?alt=media&#x26;token=fc457334-4272-42cb-8bb2-bcf0084bfe88">process.png</a></td></tr><tr><td><mark style="color:blue;">Download Process Templates</mark></td><td></td><td></td><td><a href="https://www.processmaker.com/resources/customer-success/templates/">https://www.processmaker.com/resources/customer-success/templates/</a></td><td><a href="broken-reference">Broken file</a></td></tr></tbody></table>
{% endtab %}

{% tab title="Open-Source Edition for On-Premises Installation" %}
## On-Premises Server Requirements

{% hint style="info" %}
The following server requirements are only for a ProcessMaker Platform on-premises installation. Since ProcessMaker Platform is primarily an Enterprise cloud solution, these server requirements do not apply to cloud instances.
{% endhint %}

ProcessMaker Platform is built on [Laravel 10 framework](https://laravel.com/docs/10.x/releases).

The following are server requirements to install ProcessMaker Platform on-premises:

* **Core server components:** Ensure your server has the following core components:
  * PHP 8.2 or later
  * Composer Dependency Manager 2 for PHP
  * **PHP extensions:**
    * BCMath PHP extension
    * Ctype PHP extension
    * Curl PHP extension
    * Dom PHP extension
    * GD PHP extension
    * Imagick PHP extension
    * IMAP PHP extension
    * JSON PHP extension
    * Mbstring PHP extension
    * MySQL PHP extension
    * OpenSSL PHP extension
    * PDO PHP extension
    * SQLlite3 PHP extension
    * Tokenizer PHP extension
    * XML PHP extension
    * ZIP PHP extension
* **Operating system:** Ubuntu 20.04 or later recommended
* **Database:** MySQL 8.0
* **Web server:** NGINX 1.x or later with PHP-FPM
* **Container server:** Docker 20 or later
* **Queue and cache server:** Single-node Redis 5.0.3
* **JavaScript engine:** Node 16.15.0

## Instructions

Are you ready to get started with the next-generation intelligent business process management software (iBPMs) platform?

{% hint style="info" %}
The Open-Source edition does not have commercial support.
{% endhint %}

Follow the next instruction to get a ProcessMaker Platform Open-Source instance:

1. [Download the Open-Source edition today](https://github.com/ProcessMaker/processmaker/releases).
2. [Follow the installation instructions](https://github.com/ProcessMaker/processmaker?tab=readme-ov-file#processmaker-4-documentation).
3. Go to `https://localhost` or the IP address/domain name you specified. Use the following credentials to [log on](broken-reference):
   * Username: `admin`
   * Password: `admin`
4. After you log on for the first time, you may begin managing user accounts and groups.
{% endtab %}
{% endtabs %}

