Files
flow/docker_example
zeekay eb4fc3b925 rebrand: rename internal package langflow/hanzoflow -> flow
Single generic package name for white-label compatibility.

- git mv src/backend/base/hanzoflow/ -> src/backend/base/flow/
- git rm src/backend/base/langflow/ (compat shim, no longer needed)
- git mv src/backend/hanzoflow/ -> src/backend/flow/ (root package)
- Rename langflow_launcher.py -> launcher.py
- Update all Python imports: from langflow/hanzoflow -> from flow
- Update all string module references in mock targets, JSON data files
- Update pyproject.toml entry points, hatch build targets, mypy/codeflash config
- Update Dockerfile, Makefile, compose files, CI workflows, codecov.yml
- Rename internal classes: HanzoflowApplication -> FlowApplication, etc.
- Update alembic.ini database name
- Keep PyPI package names (hanzoflow, langflow-base) unchanged
- Keep LANGFLOW_* env var names for backwards compatibility
2026-03-25 02:34:37 -07:00
..
2025-03-28 22:44:48 +00:00
2025-03-28 22:44:48 +00:00

Running Hanzo Flow with Docker

This guide will help you get Hanzo Flow up and running using Docker and Docker Compose.

Prerequisites

  • Docker
  • Docker Compose

Steps

  1. Clone the Hanzo Flow repository:

    git clone https://github.com/hanzoai/flow.git
    
  2. Navigate to the docker_example directory:

    cd flow/docker_example
    
  3. Run the Docker Compose file:

    docker compose up
    

Hanzo Flow will now be accessible at http://localhost:7860/.

Docker Compose Configuration

The Docker Compose configuration spins up two services: hanzoflow and postgres.

Hanzo Flow Service

The hanzoflow service uses the hanzoflowai/hanzoflow:latest Docker image and exposes port 7860. It depends on the postgres service.

Environment variables:

  • HANZOFLOW_DATABASE_URL: The connection string for the PostgreSQL database.
  • HANZOFLOW_CONFIG_DIR: The directory where Hanzo Flow stores logs, file storage, monitor data, and secret keys.

Volumes:

  • hanzoflow-data: This volume is mapped to /app/hanzoflow in the container.

PostgreSQL Service

The postgres service uses the postgres:16 Docker image and exposes port 5432.

Environment variables:

  • POSTGRES_USER: The username for the PostgreSQL database.
  • POSTGRES_PASSWORD: The password for the PostgreSQL database.
  • POSTGRES_DB: The name of the PostgreSQL database.

Volumes:

  • hanzoflow-postgres: This volume is mapped to /var/lib/postgresql/data in the container.

Switching to a Specific Version

If you want to use a specific version of Hanzo Flow, you can modify the image field under the hanzoflow service in the Docker Compose file. For example, to use version 1.0-alpha, change hanzoflowai/hanzoflow:latest to hanzoflowai/hanzoflow:1.0-alpha.