FlatRun is actively evolving. This roadmap outlines our major planned milestones and features. We're building FlatRun in the open, and community feedback shapes our priorities.
v0.1.x — Foundation
The current stable release with core functionality:
- Docker Compose-based deployment management
- Built-in templates for common applications
- Nginx reverse proxy integration
- Let's Encrypt SSL automation
- Database management (MySQL, PostgreSQL, MariaDB)
- REST API with JWT authentication
- Web UI dashboard
- Container and resource monitoring
Templates Server
Decouple templates from the agent for flexibility and community contributions
Overview
Currently, templates are embedded directly in the FlatRun agent binary at compile time. While this ensures templates are always available, it limits flexibility. The Templates Server milestone will introduce a dedicated service for template management.
Key Features
- Standalone Templates Server — A dedicated service (or module) that hosts and serves templates independently from the agent
- Remote Template Registry — Fetch templates from configurable remote repositories (official and community)
- Custom Template Creation — Simple workflow for users to create, validate, and share their own templates
- Template Versioning — Version control for templates with ability to pin specific versions
- Hot Reload — Add or update templates without restarting the agent
- Template Validation — Built-in validation to ensure templates meet quality standards
- Private Registries — Support for self-hosted template registries for organizations
Benefits
- Community can contribute templates without agent releases
- Organizations can maintain private template libraries
- Faster iteration on template improvements
- Smaller agent binary size
- Templates can be customized per environment
Architecture
┌─────────────────┐ ┌──────────────────┐
│ FlatRun Agent │────▶│ Templates Server │
└─────────────────┘ └──────────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Official Repo │ │ Community Repo │ │ Private Repo │
│ (templates. │ │ (github.com/ │ │ (your-company/ │
│ flatrun.io) │ │ user/templates)│ │ templates) │
└─────────────────┘ └─────────────────┘ └─────────────────┘Marketplace
A central hub for discovering and sharing templates, plugins, and applications
Overview
Building on the Templates Server, the Marketplace will be a community-driven platform where users can discover, share, and install templates and plugins. Think of it as an app store for your FlatRun deployments.
Key Features
- Template Marketplace
- Browse and search community-contributed templates
- Ratings, reviews, and download counts
- Categories and tags for easy discovery
- One-click installation from the UI
- Automatic updates notification
- Application Bundles
- Pre-configured multi-service applications
- Complete stacks (e.g., LAMP, MEAN, WordPress + Redis + Nginx)
- Production-ready configurations with best practices
- Plugins Ecosystem
- Extend FlatRun functionality with plugins
- Custom dashboard widgets
- Integration plugins (Slack, Discord, monitoring tools)
- Backup and migration plugins
- Security scanning plugins
- Publisher Features
- Publisher accounts for template/plugin authors
- Documentation hosting for published items
- Analytics for publishers (downloads, ratings)
- Verified publisher badges
Marketplace Categories
Benefits
- Discover new applications and tools easily
- Share your configurations with the community
- Learn from production-ready templates
- Extend FlatRun with powerful plugins
- Build reputation as a template/plugin author
Beyond
Additional features under consideration:
- Multi-node Support — Manage deployments across multiple servers
- Backup & Restore — Automated backup scheduling and one-click restore
- CI/CD Integration — GitOps workflows and automated deployments
- Alerting — Notifications for deployment issues and resource thresholds
- Team Management — Role-based access control and audit logs
- Resource Quotas — Limit resources per deployment or user
Get Involved
The roadmap is shaped by community feedback. Here's how you can participate:
- Vote on Features — Star or comment on GitHub issues for features you want
- Submit Ideas — Open a GitHub Discussion for new feature proposals
- Contribute Code — Help implement roadmap features (see Contributing)
- Create Templates — Prepare templates for the upcoming marketplace