Skip to main content
This guide adds ASEE Flow WebAdmin to a fresh Spring Boot application. In about ten minutes you’ll have the admin UI running at /webadmin with form-based login.

​
Prerequisites

​
1. Create a Spring Boot application

Generate a project at start.spring.io with Maven, Java 17, Jar packaging, and the JDBC and H2 Database dependencies. Extract it and open it in your IDE.

​
2. Add the ASEE Flow repositories

WebAdmin and the BPM platform are published to Repsy. Add both repositories to your pom.xml: 
<repositories>
  <repository>
    <id>repsy</id>
    <url>https://repo.repsy.io/mvn/asee/aseeflow</url>
  </repository>
  <repository>
    <id>repsy-webadmin</id>
    <url>https://repo.repsy.io/mvn/asee/aseeflow-webadmin</url>
  </repository>
</repositories>
Reload Maven after saving.

​
3. Add the dependencies

Add the engine webapp, WebAdmin starter, engine REST, and Spring Security to <dependencies>: 
<dependency>
  <groupId>org.aseeflow.bpm.springboot</groupId>
  <artifactId>aseeflow-bpm-spring-boot-starter-webapp</artifactId>
  <version>${aseeflow.bpm-platform.version}</version>
</dependency>
<dependency>
  <groupId>org.aseeflow.webadmin</groupId>
  <artifactId>aseeflow-webadmin-spring-boot-starter</artifactId>
  <version>${aseeflow.webadmin.version}</version>
</dependency>
<dependency>
  <groupId>org.aseeflow.bpm.springboot</groupId>
  <artifactId>aseeflow-bpm-spring-boot-starter-rest</artifactId>
  <version>${aseeflow.bpm-platform.version}</version>
</dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-security</artifactId>
</dependency>
Define the versions in <properties> (use the latest available versions): 
<properties>
  <aseeflow.bpm-platform.version>1.0.0-beta-6</aseeflow.bpm-platform.version>
  <aseeflow.webadmin.version>0.8.6-SNAPSHOT</aseeflow.webadmin.version>
</properties>
spring-boot-starter-security is declared as provided inside the WebAdmin starter, so you must include it explicitly. WebAdmin must never be left without a security layer.
What each dependency does:
  • aseeflow-bpm-spring-boot-starter-webapp — the ASEE Flow engine and web apps.
  • aseeflow-webadmin-spring-boot-starter — the WebAdmin React UI and backend, served at /webadmin.
  • aseeflow-bpm-spring-boot-starter-rest — the engine REST API that WebAdmin consumes.
  • spring-boot-starter-security — required for a production-ready security layer.

​
4. Configure the datasource and admin user

Create src/main/resources/application.yaml: 
spring:
  h2:
    console:
      enabled: true
  datasource:
    driver-class-name: org.h2.Driver
    username: sa
    password: sa
    url: jdbc:h2:file:./camunda-h2-database;AUTO_SERVER=TRUE

camunda.bpm:
  admin-user:
    id: demo
    password: demo
    firstName: demo
    lastName: demo

aseeflow:
  webadmin:
    authentication: form
Form-based login gives a branded login page and is easy to swap for SSO later. See Authentication for the other modes.

​
5. Run and verify

mvn spring-boot:run
Then open:
  • WebAdmin UI — http://localhost:8080/webadmin (log in with demo / demo)
  • Engine REST — http://localhost:8080/engine-rest
  • H2 console — http://localhost:8080/h2-console