Skip to content

Release history

DockFlare releases

DockFlare: Automate Cloudflare Tunnels with Docker Labels

All releases

7 shown

v3.1.2 Bug fix
Notable features
  • New DockFlare logo with light and dark SVG variants that auto-switch based on theme
  • Unified visual design system across website, Master app, and Webmail client
  • Redesigned login screens with split-panel layout supporting light/dark mode
Full changelog

Hello everyone,

v3.1.2 is a visual release.

No new infrastructure, no new services. This one is about making DockFlare feel cohesive the same design language across the website, the Master app, and the Webmail client. While I was at it, the login screens got a proper redesign.

Highlights

  • New DockFlare logo dedicated light and dark SVG variants, auto-switching everywhere
  • Website, Master, and Webmail now share the same visual design system
  • Login screens redesigned with a split-panel layout
  • All assets bundled locally no CDN, no external requests

What's New

New Logo

DockFlare has a proper logo now with separate light and dark SVG variants. The GitHub README already uses it if you're reading this in dark mode you should see the light version, and vice versa. Both the website and all app surfaces serve the correct variant automatically based on your active theme.

Design Sync

The website, Master app, and Webmail client now speak the same visual language same colours, same typography, same component style. Previously each surface had drifted slightly. That drift is gone.

Login Pages

Both login screens have been redesigned with a 50/50 split panel and a refreshed form card. Toggle between light and dark mode on the login screen the panel colours invert and the logo switches variant automatically. Worth a look.

Fixed

Outbound display name: The display name set during mailbox creation was stored but never applied when sending. Outbound emails now correctly use Display Name <address> in the From header. Thanks to the community for the report — #363.

Notes

No changes to agents, Docker Compose, or Cloudflare configuration. Master and Webmail update by pulling the new images.


For the full breakdown see CHANGELOG.md.

Happy tunnelling,
Christian

v3.1.1 Breaking risk
Notable features
  • Email aliases with SMTP-level enforcement via Cloudflare Worker KV
  • Outbound reply support from aliases to hide real address
  • Bulk email actions (multi-select, trash, folder moves)
Full changelog

Hello everyone,

v3.1.1 is out.

The headline feature is email aliases - a disposable address layer built directly into DockFlare Mail, no third-party service required. Alongside that, a round of webmail UI improvements landed in this release including inline settings, bulk email actions, and a handful of dark mode and layout fixes.

Highlights

  • Email aliases: create disposable addresses that route to your real mailbox
  • Alias enforcement at the Cloudflare Worker layer - unknown aliases rejected at the SMTP level
  • Outbound reply support: reply from an alias, not your real address
  • Bulk email actions: select, trash, and move multiple messages at once
  • Settings redesigned as an inline split panel
  • Date and time format selector: US, European, or ISO 8601

What's New

Email Aliases

Thanks to [@f3vkx](https://github.com/f3vkx) for the idea in [#348](https://github.com/ChrispyBacon-dev/DockFlare/discussions/348).

You can now create email aliases that forward mail to your real mailbox while keeping your actual address private - similar to SimpleLogin or addy.io, but self-hosted and built into the platform.

Aliases are enforced at the Cloudflare Worker layer via KV lookups. Mail to an unknown or deactivated alias is rejected at the SMTP level before it ever reaches your server.

Full management is available from the webmail Settings panel:

  • Generate an alias automatically or define a custom local-part
  • Add a label and description for organisation
  • Set an optional expiry date - expired aliases are deactivated automatically by an hourly background job and their KV entries cleaned up from Cloudflare
  • Toggle aliases active or inactive at any time
  • Track usage count per alias

Outbound reply support: when you reply to a message that arrived via an alias, the compose dialog pre-selects that alias as the sender. Your real address stays hidden end to end.

Rate limiting: 20 alias creations per hour and 100 aliases per mailbox, enforced server-side.

Inline Settings Panel

The settings modal is replaced with a split-panel view inside the main mail area. Clicking any folder closes settings and returns to mail. Three new sections added: Appearance (date/time format), About (project links, PWA install), and Help (documentation placeholder).

Bulk Email Actions

Multi-select mode in the message list with select-all, trash, and folder move controls.

Webmail UI Refinements

Animated logo in the sidebar and login page, sidebar controls reorganised, folder section label cleaned up, and several unnecessary dividers removed.

Notes

No changes to the DockFlare Master, agent, or Docker Compose configuration. Webmail and Mail Manager update by pulling the new images.


For the full breakdown see [CHANGELOG.md](https://github.com/ChrispyBacon-dev/DockFlare/blob/stable/CHANGELOG.md).

Happy tunnelling,
Christian

v3.1.0 New feature
Notable features
  • Self-hosted email using Cloudflare Email Routing, Workers, and R2 for stateless relay
  • PWA webmail client with Web Push notifications, multi-domain support, and per-mailbox quotas
  • One-click provisioning of Cloudflare infrastructure from UI with repair and teardown tools
Full changelog

Hello everyone,

v3.1.0 is a big one. Probably the biggest feature release since the multi-server agent system in v3.0.

This release introduces DockFlare Mail a fully self-hosted email suite that uses Cloudflare as a zero-infrastructure delivery layer while keeping every message, attachment, and mailbox record on your own hardware. No third-party mail servers. No SaaS subscriptions. No sending your email to someone else's cloud.

Cloudflare handles the edge. You keep the data.

Cloudflare's Email Service entered public beta today. Read their announcement: Email for Agents

Highlights

  • Self-hosted inbound and outbound email via Cloudflare Email Routing, Workers, and R2
  • Local email storage in SQLite with FTS5 full-text search everything stays on your server
  • Multi-domain support with complete per-domain isolation of secrets, buckets, and Workers
  • One-click provisioning of all required Cloudflare infrastructure from the DockFlare UI
  • PWA-ready Webmail client installable on desktop and mobile
  • Desktop and mobile push notifications for new mail via Web Push (VAPID)
  • Per-mailbox storage quotas enforced at the Cloudflare KV layer
  • Backup, restore, and full teardown tooling built in
  • 7 new Help Center guides covering every part of the email setup

What's New

DockFlare Mail

DockFlare Mail turns Cloudflare into a stateless mail relay that you own and control.

Inbound emails arrive at Cloudflare, get routed through an Email Worker, buffered briefly in R2, and pulled down to your server by the new Mail Manager service. Outbound mail goes the other direction from your server, through an authenticated Cloudflare Worker with automatic SPF, DKIM, and DMARC handling, and out to the internet.

Your messages live in a local SQLite FTS5 database. Your attachments live in a dedicated Docker volume. Cloudflare never stores your email permanently it is a pipe, not a vault.

One-Click Infrastructure Provisioning

The Email Setup flow provisions everything directly from the DockFlare UI:

  • Cloudflare Email Routing and catch-all rules
  • Inbound and outbound Workers with correct bindings
  • R2 buckets for message buffering
  • MX, SPF, DMARC, and DKIM DNS records

A Repair DNS tool is also available to re-apply or fix missing records if anything drifts. Worker redeployment is one click whenever you push configuration changes.

Multi-Domain Support

DockFlare Mail supports an unlimited number of domains simultaneously, with complete isolation per domain:

  • Separate secrets, R2 buckets, and Worker endpoints per domain
  • Domain-aware inbound webhook routing with per-domain signature verification
  • Dynamic sync of domain configuration from the Master to the Mail Manager

PWA Webmail

The included Webmail client is built with Vue 3, Vite, and TypeScript.

It runs as a Progressive Web App installable directly from the browser on desktop and with mobile support soon. The interface uses a 3-panel layout with folder navigation, message list, and rich message display. Push notifications for new mail are supported via Web Push (VAPID) and Service Workers, so new messages reach you even when the app is in the background.

Per-Mailbox Quotas

Storage quotas are enforced at the Cloudflare KV layer, so the check happens before a message is delivered to your server. When a mailbox is full, incoming messages are rejected cleanly at the edge no surprise disk usage, no silent drops. Quota configuration and current usage are visible in the mailbox management UI.

Backup, Restore, and Teardown

Full backup and restore of the mail database and data volume is built in. Teardown options including a complete wipe of local data and Cloudflare resources are available directly from the Email section.

Security

  • EdDSA JWT authentication Ed25519 key pair-based communication between Webmail, Mail Manager, and Master
  • Outbound rate limiting 50 emails per hour, 200 per day per sender, enforced at the Worker layer
  • CVE scan and dependency refresh included in this release

Changed

  • Navigation: Email is now a primary item in the Master navigation bar
  • Login page: A "Login to Email" shortcut appears on the main login page when email services are active
  • Docker Compose: Updated to include dockflare-mail-manager and dockflare-webmail services under a shared email profile opt-in, no impact on existing setups

Help Center

Seven new guides covering the full email setup are now available in the Help Center (English):

Notes

Email services are fully opt-in. Existing installations are unaffected unless the email profile is added to the Compose configuration.


For the full technical breakdown see CHANGELOG.md.

Happy tunneling,
Christian

v3.0.9 New feature
Notable features
  • One-liner install script for master
  • One-liner agent deployment
  • Cloudflare Zero Trust integration
v3.0.8 New feature
Security fixes
  • Dependency security refresh across frontend and Python stack
Notable features
  • 9 new language translations
  • Help Center translations
  • Website translations
v3.0.7 New feature
Notable features
  • Manual SNI control toggle
  • Unmanaged field preservation setting
  • Dashboard grouping by status/tunnel/policy
v3.0.6 Bug fix

Optimized Docker event listening to reduce noise and resource usage by filtering to explicitly opted-in containers. Clarified Access Policy labeling to avoid public service misconception.

Beta — feedback welcome: [email protected]