Project

Roadmap

What FlatRun does today, what is being built next, and what is still only wanted.

This page separates three things: what ships in the current release, the one large piece being built next, and what is still only wanted. FlatRun is built in the open and community feedback shapes the order.

Current Release

v0.4.0-beta

What ships today.

Deploying

  • Docker Compose Standard compose files, managed in place, portable without FlatRun
  • Templates Pre-configured apps, delivered from a remote catalog rather than baked into the binary
  • Deploy from source Build and run straight from a git repository
  • Registries and credentials Private images from Docker Hub, GHCR, ECR, and any other registry
  • Plan and apply Preview any change before it runs, and require review on the deployments that matter
  • Reverse proxy and SSL Domains routed automatically, certificates issued and renewed by Let's Encrypt
  • DNS management Zones on the host, or records through your provider

Operating

  • Metrics and alerts Container and host metrics on OpenTelemetry conventions, with rules that notify or repair
  • Dashboards Charts you assemble, saved on the server rather than in one browser
  • Logs Deployment output per service, application log files, and the proxy's own access and error logs
  • Traffic analytics Every request through the proxy, attributed to a deployment
  • Notifications Webhook, chat, and email targets, reused by every rule that needs to reach you
  • Scheduled tasks Cron-based jobs with execution history
  • Browser terminal and file manager Shell into a container or edit a file without SSH or FTP
  • Database management MySQL, MariaDB, and PostgreSQL: databases, users, tables, and queries

Keeping it safe

  • Backup and restore Scheduled, retained, restorable in one click
  • Object stores S3-compatible storage FlatRun runs for you or connects to, usable as a backup target, mountable into a deployment, replicable offsite
  • RBAC Roles, granular permissions, and per-deployment access scoping
  • Audit logging A trail of who changed what
  • Security monitoring Threat detection, IP blocking, and rate limiting at the proxy
  • Protected mode Mark a deployment so destructive actions are refused outright

Automating

  • REST API Everything the UI does, available to your own tools
  • CLI and GitHub Action Ship on every push from any compatible runner
  • AI assistant Inspects, proposes, and acts under the governance you set. Bring your own model
  • MCP server The same tool set exposed to external agents, permission-gated
  • Agent runtimes Agents written as plain markdown files, versioned in git
  • Plugins Apps that run beside the agent and contribute their own UI, the way observability does
  • Clustering Federate servers and manage them from one panel, with no shared database
  • One-line installer and cloud images Setup script, plus pre-built images for DigitalOcean and AWS
Major Milestone

Marketplace

A place to find, publish, and trust what other people have already built

Where this stands

The groundwork is done. Templates no longer live inside the agent binary: the catalog is fetched from an external origin, cached on disk, and refreshed without a restart, with a GitHub repository as the working default and the agent's own embedded set as a fallback. Adding or updating an app no longer waits for an agent release.

What is left is the part that needs a service behind it: publishing, discovery, and the trust signals that make installing a stranger's template reasonable.

Still to come

  • Publishing Publisher accounts, versioned releases, and hosted documentation for what you publish
  • Discovery Search, categories, download counts, ratings, and verified publishers
  • Private registries Organizations serving their own catalog to their own fleet
  • Version pinning Hold a deployment on a known template version, and see when a newer one lands
  • Validation Checks a template must pass before it is offered to anyone
  • Plugin distribution The same route for plugins, so third-party apps install as easily as first-party ones

Categories we expect to see

CMS & Blogging WordPress, Ghost, Strapi, Directus
E-commerce WooCommerce, Magento, Medusa
Development GitLab, Gitea, Code Server
Monitoring Grafana, Prometheus, Uptime Kuma
Communication Mattermost, Rocket.Chat, Matrix
Storage Nextcloud, MinIO, PhotoPrism
Major Milestone

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

CMS & Blogging WordPress, Ghost, Strapi, Directus
E-commerce WooCommerce, Magento, Medusa
Development GitLab, Gitea, Code Server
Monitoring Grafana, Prometheus, Uptime Kuma
Communication Mattermost, Rocket.Chat, Matrix
Storage Nextcloud, MinIO, PhotoPrism

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
Future

Beyond

Wanted, not yet built:

  • Resource quotas Ceilings per deployment and per user, on top of the per-container limits that exist today
  • Backup encryption Archives encrypted at rest, so an offsite copy is safe wherever it lands
  • Database export Dump a whole database from the manager, not only the rows on screen
  • More managed store engines SeaweedFS and Garage alongside MinIO
  • Deploy on push A repository event triggering the deployment, without a runner in between

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

Stay Updated

Follow our progress on GitHub to get updates on roadmap milestones.

View on GitHub
Star us on GitHub