# Deploy Puppetflow with Easypanel

URL: /templates/puppetflow

Puppetflow is a self-hosted browser automation platform for writing, running, scheduling, and monitoring JavaScript workflows. It provides a visual flow builder, live browser streaming, human validation steps, reusable snippets, run history, artifacts, a REST API, and a remote MCP server.

## Installation notes

Open the main app domain to create your first account and browser workflow.
The template also creates a separate public domain for live browser streaming.
Keep both domains enabled. The first startup runs database migrations and may
take a few minutes while Pinokio downloads the browser archive.

Application data, execution artifacts, uploads, and browser downloads are
stored in persistent volumes. Back up the `storage`, `execution`, `uploads`,
and `browsers` volumes before moving the installation.


## Benefits

### Keep Automation Under Your Control

Run browser workflows and keep credentials, sessions, run state, and artifacts on infrastructure you manage.

### Build and Debug Visually

Create code or node-based flows, watch browser sessions live, inspect logs, and replay recordings when a run needs investigation.

### Automate Safely

Pause a workflow for human validation before a sensitive step, then continue the same browser session after approval.

## Features

### Browser Workflows

Write JavaScript workflows or assemble node-based flows for repeatable browser automation.

### Live Browser Streaming

Watch active browser sessions and take control when manual interaction is required.

### Scheduling and Integrations

Run flows manually, on schedules, through the REST API, from n8n, or from AI clients through the remote MCP server.

### Run History and Artifacts

Review logs, outputs, screenshots, downloads, and browser recordings for every execution.

## Configuration

- `appServiceName` (App Service Name, required): puppetflow

- `appServiceImage` (App Service Image, required): ghcr.io/puppetflow/puppetflow:v2026.9.39

- `streamServiceImage` (Browser Stream Service Image, required): ghcr.io/puppetflow/puppetflow-stream-server:v2026.9.39

- `pinokioServiceImage` (Browser Gateway Service Image, required): ghcr.io/puppetflow/pinokio:v2026.9.6

## Services

- puppetflow: app (ghcr.io/puppetflow/puppetflow:v2026.9.39)

- puppetflow-queue: app (ghcr.io/puppetflow/puppetflow:v2026.9.39)

- puppetflow-scheduler: app (ghcr.io/puppetflow/puppetflow:v2026.9.39)

- puppetflow-stream: app (ghcr.io/puppetflow/puppetflow-stream-server:v2026.9.39)

- puppetflow-pinokio: app (ghcr.io/puppetflow/pinokio:v2026.9.6)

- puppetflow-redis: redis

## Resources

- [Website](https://puppetflow.com)

- [Documentation](https://docs.puppetflow.com)

- [GitHub](https://github.com/puppetflow/puppetflow)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/puppetflow)