Instalación

Requisitos del sistema

Antes de proceder con la instalación, asegúrate de que tu sistema cumpla con los siguientes requisitos mínimos:

Sistema operativo: Windows, Linux o macOS de 64 bits
RAM: Mínimo 8 GB (16 GB recomendado)
Espacio en disco: Mínimo 10 GB de espacio libre
Java: JDK o JRE versión 21

Verifica tu instalación de Java ejecutando:

java -version

Métodos de instalación

Distribución portátil

La distribución portátil te permite ejecutar Flowset Control sin dependencias adicionales (excepto Java). Se distribuye como un JAR de aplicación autónomo y se ejecuta con una base de datos HSQLDB integrada, que se crea automáticamente en el primer arranque — no se requiere ninguna base de datos externa. Ideal para pruebas rápidas o desarrollo local.

Get the latest Flowset Control distribution package from the official downloads page.

Download

Requisitos previos:

Componente	Requisito
Java	JDK o JRE 17 (Java 21 también es compatible)
Sistema operativo	Linux, macOS o Windows
Puerto 8081	Debe estar libre (configurable, véase más abajo)
RAM	Al menos 512 MB disponibles para la JVM

Componente

Requisito

Java

JDK o JRE 17 (Java 21 también es compatible)

Sistema operativo

Linux, macOS o Windows

Puerto 8081

Debe estar libre (configurable, véase más abajo)

RAM

Al menos 512 MB disponibles para la JVM

El archivo tiene la siguiente estructura:

flowset-control-community/
├── flowset-control-community-2026.0.1-rc.jar   # JAR de aplicación compilado
├── run.sh  / run.bat                           # iniciar la aplicación
├── stop.sh / stop.bat                          # detener la aplicación
├── data/                                       # datos de HSQLDB (se crea automáticamente)
└── README.md

Instrucciones de ejecución:

Descarga el archivo portátil desde el enlace proporcionado.
Extrae el archivo en el directorio de tu preferencia.
Ejecuta el script de lanzamiento según tu sistema operativo:

Linux/macOS:
```
chmod +x run.sh
./run.sh
```
Windows:
```
run.bat
```
Al arrancar, el script verifica Java, inicia la aplicación y abre automáticamente el navegador una vez que está lista.
Acceda a la aplicación en: http://localhost:8081.

Credenciales predeterminadas: admin/admin. Cambie la contraseña predeterminada inmediatamente después del primer inicio de sesión.

Detener la aplicación:

Linux/macOS:

./stop.sh

Windows:

stop.bat

Cambiar el puerto HTTP:

Si el puerto 8081 ya está en uso, indique un puerto diferente al iniciar:

./run.sh --server.port=8090

run.bat --server.port=8090

La HSQLDB integrada almacena sus archivos en la carpeta data/ junto al JAR. Está pensada para evaluación y desarrollo local. Para producción, utilice la configuración de base de datos externa con Oracle o PostgreSQL.

Docker Compose

Este método permite un inicio rápido de Flowset Control en contenedores, sin configuración manual de la base de datos o del entorno.

Requisitos previos:

Docker y Docker Compose
Verifica las instalaciones:
```
docker --version
docker compose version
```

Instrucciones de ejecución:

Crea un archivo docker-compose.yml con:

version: '3.8'

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: flowset-control
      POSTGRES_USER: root
      POSTGRES_PASSWORD: root
    ports:
      - "5432:5432"

  flowset-control:
    image: flowset/flowset-control-community:latest
    environment:
      MAIN_DATASOURCE_URL: jdbc:postgresql://postgres:5432/flowset-control
      MAIN_DATASOURCE_USERNAME: root
      MAIN_DATASOURCE_PASSWORD: root
      SERVER_PORT: 8081
    ports:
      - "8081:8081"
    depends_on:
      - postgres

Inicia los contenedores:
```
docker compose up -d
```
Accede a la aplicación en: http://localhost:8081.
Para detener los contenedores:
```
docker compose down
```

Encontrarás instrucciones detalladas en GitHub.

Compilación desde el código fuente

Compila y ejecuta desde el código fuente para desarrollo o despliegues personalizados.

Requisitos previos:

Git
Java 21 JDK
Base de datos PostgreSQL

Instrucciones de ejecución:

Clona el repositorio:

git clone https://github.com/flowset/flowset-control-community

Configura la base de datos PostgreSQL.

Flowset Control almacena datos, como las conexiones al motor BPM, en una base de datos. De forma predeterminada, Flowset Control requiere una base de datos PostgreSQL con los siguientes parámetros:
- Nombre de la base de datos: flowset-control
- Nombre de usuario: root
- Contraseña: root
Ve al directorio del proyecto y ejecuta:
```
./gradlew bootRun
```
Accede a la aplicación en: http://localhost:8081.

Paquete WildFly

Un archivo autónomo que ya incluye el servidor de aplicaciones WildFly con Flowset Control desplegado y preconfigurado. No es necesario descargar WildFly por separado ni realizar un despliegue manual. De forma predeterminada, la aplicación se ejecuta con una base de datos HSQLDB integrada, que se crea automáticamente en el primer arranque, por lo que no se necesita ninguna base de datos externa para empezar.

Requisitos previos:

Componente	Requisito
Java	JDK o JRE 17 (Java 21 también es compatible)
Sistema operativo	Linux, macOS o Windows
Puerto 8080	Debe estar libre (configurable, véase más abajo)
RAM	Al menos 2 GB disponibles para la JVM

Componente

Requisito

Java

JDK o JRE 17 (Java 21 también es compatible)

Sistema operativo

Linux, macOS o Windows

Puerto 8080

Debe estar libre (configurable, véase más abajo)

RAM

Al menos 2 GB disponibles para la JVM

El archivo tiene la siguiente estructura:

flowset-control-community-wildfly-2026.0.1/
├── server.tar.gz                         # WildFly + app desplegada (se descomprime en el primer arranque)
├── start.sh / start.bat                  # iniciar el servidor
├── stop.sh  / stop.bat                   # detener el servidor correctamente
└── README.md

En el primer arranque, server.tar.gz se descomprime automáticamente en una carpeta server/wildfly/ junto a los scripts (un paso único de unos pocos segundos):

flowset-control-community-wildfly-2026.0.1/
└── server/wildfly/                       # servidor de aplicaciones WildFly
    ├── bin/standalone.conf               # preconfigurado para Flowset Control
    └── standalone/deployments/
        └── flowset-control-community-2026.0.1.war   # ya desplegado

El servidor se distribuye como un server.tar.gz interno para que el archivo externo contenga solo rutas cortas. Esto permite abrirlo con el extractor integrado en Windows y macOS sin alcanzar el límite de 260 caracteres de ruta de Windows. La descompresión utiliza tar (integrado en Windows 10 1803+, Windows 11, macOS y Linux), que no tiene ese límite.

Instrucciones de ejecución:

Obtenga el paquete WildFly desde la página de descargas oficial.
Descomprima el archivo en el directorio de su preferencia. Mantenga intacta la estructura de carpetas — los scripts start/stop deben permanecer junto a server.tar.gz. En Windows, el extractor integrado del Explorador funciona correctamente aquí, ya que el archivo contiene solo rutas cortas.
Inicie el servidor (en el primer arranque, el servidor incluido se descomprime automáticamente):

Linux/macOS:
```
chmod +x start.sh
./start.sh
```
Windows:
```
start.bat
```
El arranque tarda aproximadamente 40–60 segundos. Un inicio correcto termina con una línea como WildFly 40.0.0.Final started in 43443ms.
Acceda a la aplicación en: http://localhost:8080.

Credenciales predeterminadas: admin/admin. Cambie la contraseña predeterminada inmediatamente después del primer inicio de sesión.

Detener el servidor:

Linux/macOS:

./stop.sh

Windows:

stop.bat

Cambiar el puerto HTTP:

Si el puerto 8080 ya está en uso, indique un puerto diferente al iniciar:

./start.sh -Djboss.http.port=8090

start.bat -Djboss.http.port=8090

Comprobación de estado (health check):

curl http://localhost:8080/actuator/health
# Esperado: {"status":"UP"}

Archivos de registro:

server/wildfly/standalone/log/server.log

Actualización a una nueva versión:

Reemplace el archivo WAR en la carpeta de despliegues mientras WildFly está en ejecución — se recarga automáticamente:

cp flowset-control-community-2026.0.1.war \
   server/wildfly/standalone/deployments/

La HSQLDB integrada está pensada para evaluación e instalaciones pequeñas. Para producción, dirija la aplicación a una base de datos externa editando server/wildfly/bin/standalone.conf — descomente el bloque main.datasource. de Oracle *o PostgreSQL y establezca la URL, el nombre de usuario y la contraseña (o proporciónelos mediante las variables de entorno FLOWSET_DB_URL / FLOWSET_DB_USER / FLOWSET_DB_PASS). Compatible con: Oracle 19c+ y PostgreSQL. Reinicie el servidor después de cambiar la configuración.

Postinstalación

Después de una instalación exitosa:

Abre tu navegador web y ve a http://localhost:8081.
Utiliza las credenciales de administrador predeterminadas (admin/admin).
Configura las conexiones de tu motor BPM.