Getting Started with DockFlare 3.0

Deploy the DockFlare Master with Redis and security hardening in minutes. Start orchestrating Cloudflare Tunnels across your infrastructure.

Prerequisites

Step 1: Create a docker-compose.yml

This file defines the DockFlare Master with Redis, socket proxy, and security hardening. Save it as docker-compose.yml in a new directory.

YAML
# DockFlare 3.0 with Redis and security hardening
version: '3.8'

services:
  docker-socket-proxy:
    image: tecnativa/docker-socket-proxy:v0.4.1
    container_name: docker-socket-proxy
    restart: unless-stopped
    environment:
      - DOCKER_HOST=unix:///var/run/docker.sock
      - CONTAINERS=1
      - EVENTS=1
      - NETWORKS=1
      - IMAGES=1
      - POST=1
      - PING=1
      - INFO=1
      - EXEC=1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      - dockflare-internal

  dockflare-init:
    image: alpine:3.20
    command: ["sh", "-c", "chown -R ${DOCKFLARE_UID:-65532}:${DOCKFLARE_GID:-65532} /app/data"]
    volumes:
      - dockflare_data:/app/data
    networks:
      - dockflare-internal
    restart: "no"

  dockflare:
    image: alplat/dockflare:stable
    container_name: dockflare
    restart: unless-stopped
    ports:
      - "5000:5000"
    volumes:
      - dockflare_data:/app/data
    environment:
      - REDIS_URL=redis://redis:6379/0
      - DOCKER_HOST=tcp://docker-socket-proxy:2375
    depends_on:
      docker-socket-proxy:
        condition: service_started
      dockflare-init:
        condition: service_completed_successfully
      redis:
        condition: service_started
    networks:
      - cloudflare-net
      - dockflare-internal
    # Optional labels to expose DockFlare itself via DockFlare
    # labels:
    #   - "dockflare.enable=true"
    #   - "dockflare.hostname=dockflare.yourdomain.tld"
    #   - "dockflare.service=http://dockflare:5000"
    #   - "dockflare.access.group=admin-team" # Use Access Groups

  redis:
    image: redis:7-alpine
    container_name: dockflare-redis
    restart: unless-stopped
    command: ["redis-server", "--save", "", "--appendonly", "no"]
    volumes:
      - dockflare_redis:/data
    networks:
      - dockflare-internal

volumes:
  dockflare_data:
  dockflare_redis:

networks:
  cloudflare-net:
    name: cloudflare-net
    external: true
  dockflare-internal:
    name: dockflare-internal

Step 2: Launch DockFlare

Start the DockFlare Master stack. The Master will coordinate tunnels and policies across your infrastructure.

BASH
docker compose up -d

Step 3: Complete the Pre-Flight Setup

Open http://your-server-ip:5000 in your browser. You will be guided through a one-time setup wizard to enter your Cloudflare credentials and create a password for the UI.

🚀 What's New in DockFlare 3.0

  • Multi-server architecture with distributed agents
  • Security hardened with least-privilege runtime
  • Redis backplane for scaling and communication
  • Access Groups for simplified policy management
  • Backup & restore with encrypted configuration

For Existing Users

If you are upgrading from v2.x, DockFlare will detect your old .env file and automatically guide you through a migration process to the new encrypted configuration format.