FiloraFS-Pro quickstart

Prerequisites

The Maven wrapper is included. System Maven, MySQL, S3, MinIO, and a .env file are not required for the first run.

• The extracted purchased source
• JDK 25
• A current browser

Run

Start without creating .env. The application uses in-memory H2, Flyway, LOCAL storage under ./uploads, and a generated JWT secret for this process.

cd FiloraFS-Pro
./mvnw spring-boot:run

Set-Location .\FiloraFS-Pro
.\mvnw.cmd spring-boot:run

Try the APIs

Open http://localhost:8080/api-test. A fresh database has no users because demo data is disabled by default.

• Register a user and log in.
• Retain the returned access and refresh credentials in the workbench's in-memory state.
• Upload a PNG, JPEG, PDF, or MP4 file with Bearer authentication.
• List, inspect, stream, download, and delete only files owned by that user.
• Generate temporary access for a file and request a thumbnail for an uploaded image.

Optional demo data

On an empty local database, FILORAFS_DEMO_DATA_ENABLED=true creates admin and user accounts with the documented local password password123123.

Verify the project

./mvnw clean verify

.\mvnw.cmd clean verify

✓ FiloraFS-Pro is running and the authenticated file flow has been verified.

Configure for development

• Copy .env.example to the ignored .env file only when overrides are needed.
• Switch H2 to MySQL for persistent metadata.
• Provide a stable high-entropy JWT secret.
• Choose a persistent relative LOCAL directory or configure S3 through the admin API/workbench.
• Set a stable external storage master key before saving S3 credentials.