alfresco/process-services repository overview

⁠What is Alfresco Process Services

Alfresco Process Services (powered by Activiti)⁠ is an open enterprise process automation software (commonly known as BPM) used by organizations to automate and drive a wide variety of business operations such as client on-boarding, investment services, patient care pathway, case management, as well as many others. At its core, it provides a lightweight, java-centric open-source BPMN process engine that integrates easily with any existing on-premise or cloud enterprise systems. It includes a suite of web-based and business-friendly tools and analytics that enable a perfect business and IT alignment for faster time to solution. The platform is extremely flexible and scalable, enabling companies to quickly design, deploy, and operate a wide range of highly customized processes. Together, Alfresco Process, Content and Governance Services provide a powerful platform for digital transformation. Learn more at: https://www.alfresco.com/⁠

⁠Run the container

To run Process Services on your own machine, type the following command into Docker:

docker run -p 8080:8080 alfresco/process-services

The service will be available at the URL http://localhost:8080/activiti-app after the download and startup has completed. The default username and password are: [email protected]/admin

⁠Configuration

There are two options for updating the properties in your own configuration.

⁠Updating the default properties

If you want to change the default configuration, you can override the environment variables below.

The following correspond to the activiti-app.properties file:

• ACTIVITI_LICENSE_MULTI_TENANT
• ACTIVITI_DATASOURCE_URL
• ACTIVITI_DATASOURCE_DRIVER
• ACTIVITI_DATASOURCE_USERNAME
• ACTIVITI_DATASOURCE_PASSWORD
• ACTIVITI_HIBERNATE_DIALECT
• ACTIVITI_ADMIN_EMAIL
• ACTIVITI_ADMIN_PASSWORD_HASH
• ACTIVITI_CORS_ENABLED
• ACTIVITI_CORS_ALLOWED_ORIGINS
• ACTIVITI_CORS_ALLOWED_METHODS
• ACTIVITI_CORS_ALLOWED_HEADERS
• ACTIVITI_CSRF_DISABLED
• ACTIVITI_ES_SERVER_TYPE
• ACTIVITI_ES_CLUSTER_NAME
• ACTIVITI_ES_DISCOVERY_TYPE
• ACTIVITI_ES_DISCOVERY_HOSTS

And the following correspond to the activiti-identity-service.properties file:

• IDENTITY_SERVICE_ENABLED
• IDENTITY_SERVICE_REALM
• IDENTITY_SERVICE_AUTH
• IDENTITY_SERVICE_SSL_REQUIRED
• IDENTTIY_SERVICE_RESOURCE
• IDENTITY_SERVICE_PRINCIPAL_ATTRIBUTE
• IDENTITY_SERVICE_ALWAYS_REFRESH_TOKEN
• IDENTITY_SERVICE_AUTODETECT_BEARER_ONLY
• IDENTITY_SERVICE_TOKEN_STORE
• IDENTITY_SERVICE_ENABLE_BASIC_AUTH
• IDENTITY_SERVICE_PUBLIC_CLIENT
• IDENTITY_CREDENTIALS_SECRET

Further information on what each environment variable specifies is available in the Process Services documentation⁠.

⁠Importing your own configuration

If you already have valid Process Services configuration file(s), you can import these instead. To do this, substitute the existing variables with:

• EXTERNAL_ACTIVITI_APP_PROPERTIES_FILE
• EXTERNAL_ACTIVITI_IDENTITY_SERVICES_PROPERTIES_FILE

and then specify the URL of your properties file(s), for example:

environment:
  EXTERNAL_PROPERTIES_FILE: https://your-s3-bucket.com/activiti-app.properties
  EXTERNAL_ACTIVITI_IDENTITY_SERVICES_PROPERTIES_FILE: https://your-s3-bucket.com/activiti-identity-service.properties

Note: The URL must be visible from the container environment. It will be provisioned to the container at start time. Note: Releases prior to Process Services 1.9 use the variable EXTERNAL_PROPERTIES_FILE to specify the location of an existing activiti-app.properties file.

⁠Licensing

Existing customers can get up-and-running by simply providing their existing product license. For a 30-day free trial license, click here⁠.

⁠Complex stacks

To run Process Services in a more complex way, please refer to our aps-docker-library repository⁠.

⁠Documentation

For further information, please consult our documentation⁠.