Main page | Explore the docs » | Backlogs | Docker
⭐ If you find FlowInquiry useful, please consider giving us a star on GitHub!. It motivates us a lot and helps the project grow!
FlowInquiry is a free, open-source tool for managing projects, tickets, and requests. It helps teams track work, set clear steps, and meet deadlines. You can define workflows, set SLAs, and keep all updates in one place. FlowInquiry is built to be simple, reliable, and easy to adapt to your team’s process.
📂 Projects – Use a Kanban board to group tasks by iteration or epic
🧩 Custom Workflows – Set request states and define how they move
⏱ SLA Tracking – Set due dates and handle items that run late
🔄 Live Updates – See changes in teams, projects, or requests as they happen
👥 Comments and Watchers – Share updates and keep the right people informed
📅 Timeline View – See the full history of a request at a glance
🧵 Change Log – Track what changed, when, and by whom
🔐 Role-Based Access – Control who can see or do what
🌍 Language Support – Use in multiple languages for global teams
🔌 Integrations – Connect with email, with Slack and GitHub coming soon
🚀 Deployment Options – Run with Docker or on your own setup; Kubernetes coming soon
FlowInquiry uses a monorepo structure to manage all parts of the application — including the backend, frontend, and documentation — in a single repository. This approach ensures consistency, shared tooling, and easier cross-service collaboration.
All core services are located in the apps/ directory:
- apps:
- backend: The Spring Boot service that powers the API layer, business logic, database integrations, workflows, and backend features of FlowInquiry.
- frontend: The Next.js web application that provides the user interface for the platform. It integrates with the backend via REST APIs, handles authentication, and supports both freemium and premium features through dynamic configuration.
- ops: the central repository that provides artifacts and configuration files to help customers deploy FlowInquiry using Docker, Kubernetes, and other environments.
- docs: A documentation site built with a Nextra static site generator, providing guides, and setup instructions for developers and users.
To get started with setting up the frontend and backend locally, follow the official developer guides:
These guides provide step-by-step instructions to help you configure your environment, install dependencies, and run the services in development mode.
Have Docker installed? Get FlowInquiry running in seconds!
# Using wget
wget -O install-flowinquiry.sh https://raw.githubusercontent.com/flowinquiry/flowinquiry/refs/heads/main/apps/ops/flowinquiry-docker/scripts/install-flowinquiry.sh && chmod +x install-flowinquiry.sh && ./install-flowinquiry.sh
# Or using curl
curl -sSL https://raw.githubusercontent.com/flowinquiry/flowinquiry/refs/heads/main/apps/ops/flowinquiry-docker/scripts/install-flowinquiry.sh -o install-flowinquiry.sh && chmod +x install-flowinquiry.sh && ./install-flowinquiry.sh
This will:
-
Download the necessary setup scripts directly from FlowInquiry's GitHub repository
-
Prompt you for basic inputs (such as whether to enable SSL)
-
Automatically configure and launch FlowInquiry
After running the installation script, you will see output similar to the following:
➜ flowinquiry-docker git:(main) ✗ install-flowinquiry.sh
🔍 Checking Docker installation...
✅ Docker and Docker Compose are properly installed and running.
📥 Checking installation directory...
✅ $USER-HOME/flowinquiry-docker already exists, preserving existing files.
🗑️ Cleaning up scripts directory...
📥 Downloading necessary files...
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/scripts/all.sh using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/scripts/shared.sh using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/scripts/backend-env.sh using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/scripts/frontend-env.sh using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/Caddyfile_http using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/Caddyfile_https using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/services_http.yml using curl
✅ File successfully downloaded to $USER-HOME/flowinquiry-docker/services_https.yml using curl
🔧 Making scripts executable...
🚀 Running setup scripts...
frontend-env.sh succeeded.
🔒 SSL Configuration
SSL is recommended when installing FlowInquiry for production use or when accessing from anywhere.
For local testing purposes, you may not need SSL.
Do you want to set up FlowInquiry with SSL? (y/n): n
⚠️ Setting up without SSL (HTTP only)
🐳 Starting services with Docker Compose...
Using host IP address: 192.168.0.78
Your service will be available at: http://192.168.0.78:1234
Using host IP address: 192.168.0.78
[+] Running 4/4
✔ Container flowinquiry-front-end-1 Recreated 0.0s
✔ Container flowinquiry-back-end-1 Recreated 0.1s
✔ Container flowinquiry-postgresql-1 Recreated 0.0s
! back-end The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested 0.0s
Attaching to back-end-1, front-end-1, postgresql-1
back-end-1 | The application will start in 0s...
front-end-1 | ▲ Next.js 15.3.1
front-end-1 | - Local: http://localhost:3000
front-end-1 | - Network: http://0.0.0.0:3000
front-end-1 |
front-end-1 | ✓ Starting...
front-end-1 | ✓ Ready in 34ms
back-end-1 | INFO 1 --- [ restartedMain] io.flowinquiry.FlowInquiryApp.logApplicationStartup:120 : ----------------------------------------------------------
back-end-1 | INFO 1 --- [ restartedMain] io.flowinquiry.FlowInquiryApp.logApplicationStartup:121 : Application 'FlowInquiry' is running! Access URLs:
back-end-1 | INFO 1 --- [ restartedMain] io.flowinquiry.FlowInquiryApp.logApplicationStartup:122 : Local: http://localhost:8080/
back-end-1 | INFO 1 --- [ restartedMain] io.flowinquiry.FlowInquiryApp.logApplicationStartup:123 : External: http://172.18.0.4:8080/
back-end-1 | INFO 1 --- [ restartedMain] io.flowinquiry.FlowInquiryApp.logApplicationStartup:124 : Profile(s): prod-
Open your browser and go to:
http://<LAN_IP>:1234 -
Find your LAN IP address in the installation logs. Look for a message like:
Using host IP address: 192.168.0.78
- Log in with the default administrator credentials:
- Username:
admin@flowinquiry.io - Password:
admin
➡️ For testing purposes, it is safe to select n (no SSL) and run FlowInquiry over plain HTTP within your local network.
➡️ For production deployments, it is strongly recommended to select y and configure SSL for secure access.
FlowInquiry also supports a manual installation process, allowing you to run each step individually if you prefer to understand what happens at each stage. Learn more in the step-by-step guide
This project is licensed under the AGPLv3 License.
We welcome contributions of all kinds — not just code!
You can:
- Star the project ⭐
- Share it on social media 📢
- Create a tutorial or video 🎥
- Report bugs or suggest improvements 🐛
- Submit a pull request 🛠️ Help with Localization 🌍 – Contribute a Translation
Read the full guide: How to Contribute to FlowInquiry
Thanks to all the contributors! 🙌
