Quickstart

Requirements

• Java 17
• Node.js and npm
• Local ports 5173 and 8080

Start development

From the repository root:

npm install
npm run dev

Default addresses:

• Web: http://localhost:5173
• API: http://localhost:8080

First-run setup

Without environment-provided system storage, the first visit opens the setup flow:

1. Choose local H2 or a supported remote relational database.
2. Enter connection details for remote storage.
3. Validate the connection.
4. Create the super administrator.
5. Sign in and open the connection manager.

Before saving any remote storage or data-source password in production, configure a stable APP_SECRET or STORAGE_CONFIG_SECRET.

Add a data source

1. Select or create a data-source group.
2. Choose an installed JDBC driver.
3. Enter the JDBC URL, username, and password.
4. Test the connection.
5. Save it and open the database workspace.

Continue with Configuration and security and Data-source workflows.