Data Flow
Understanding how data flows through ComfyDeploy
This document outlines the core data flow in ComfyDeploy, focusing on what matters most to you: your workflows, run history, and outputs.
Data Components
| Component | Type | Storage | Access |
|---|---|---|---|
| Workflows | .json | postgres | Dashboard / API |
| Models | .safetensors | volume | Dashboard / API |
| Run records | .json | postgres | Dashboard / API |
| Inputs | .png / .jpg / .webp | s3 | Dashboard / API |
| Outputs | .png / .jpg / .webp | s3 | Public unique URL / Dashboard / API |
Note: This is a high-level overview of ComfyDeploy's data flow. Some technical details and advanced features may be simplified for clarity.
Warning: Custom S3 Integration requires a Business Plan.
Importing a workflow
| Step | Action | Result |
|---|---|---|
| 1 | Import workflow | Workflow.json saved to postgres |
| 2 | Machine config | Machine config saved to postgres |
| 3 | Create machine | Machine image built and ready to serve |
Using Session
| Step | Action | Result |
|---|---|---|
| 1 | Getting workflow | Workflow.json loaded from postgres |
| 2 | Start ComfyUI session | Queue job to start ComfyUI session |
| 3 | ComfyUI session started | Session URL returned to user |
| 3 | Run workflow | Workflow runs and outputs saved to ComfyDeploy |
| 4 | Output results | Access via ComfyUI session |
Workflow / API Run
| Step | Action | Result |
|---|---|---|
| 1 | Receive user inputs | Image upload to s3 |
| 2 | Execute workflow | Creates run record |
| 3 | Monitor progress | Updates in run history |
| 4 | Generate outputs | Stored in ComfyDeploy |
| 5 | Output results | Access via public unique URL |
If you are interested in using your own media storage, you can use our Custom S3 Integration to store your media in your own S3 bucket.