Skip to main content
Floci can be run three ways: as a Docker image (recommended), as a pre-built native binary, or built from source. No installation required beyond Docker itself. 
docker pull hectorvent/floci:latest

​
Requirements

  • Docker 20.10+
  • docker compose v2+ (plugin syntax, not standalone docker-compose)

​
Image tags

TagDescription
latestNative image — sub-second startup, low memory (default)
x.y.zNative image — specific release version
latest-jvmJVM image — most compatible
x.y.z-jvmJVM image — specific release version

​
Native vs JVM

​
Startup and memory comparison

ImageTagTypical startupIdle memory
Nativelatest / x.y.z< 100 ms~50 MB
JVMlatest-jvm / x.y.z-jvm~2 s~250 MB

​
Docker Compose snippet

The following docker-compose.yml uses the native image and mounts a local data directory for persistent storage: 
services:
  floci:
    image: hectorvent/floci:latest
    ports:
      - "4566:4566"
    volumes:
      - ./data:/app/data
Start Floci in the background: 
docker compose up -d
All services are available at http://localhost:4566.

​
Build from source

1

Install prerequisites

  • Java 25+
  • Maven 3.9+
  • (Optional) GraalVM Mandrel for native compilation
2

Clone the repository

git clone https://github.com/hectorvent/floci.git
cd floci
3

Run in dev mode

Start Floci with hot reload on port 4566:
mvn quarkus:dev
4

Build a production JAR

Package and run a production JAR:
mvn clean package -DskipTests
java -jar target/quarkus-app/quarkus-run.jar
5

Build a native executable (optional)

Compile a self-contained native binary:
mvn clean package -Pnative -DskipTests
./target/floci-runner
Native compilation requires GraalVM or Mandrel with the native-image tool on your PATH. Build time is typically 2–5 minutes.

Build docs developers (and LLMs) love

Get started for freeTalk to us