📘 Tutorial run-comfyui-image¶

This tutorial reflects my own experience on RunPod.
Always consult the excellent official RunPod documentation.

Common tasks¶

Start a pod
Connect to your pod
Open the web terminal
Log in to Code-Server
Configure secrets
Download models and LoRAs
Link models
Delete models and LoRAs
Manage the pod
Upload and download files
Use RunPod API

🚀 Starting a Pod¶

🧩 Choose a Template¶

t2v template

Example:

Steps:

Choose a GPU
Edit template settings if needed.
Choose Volume disk (/workspace)
Enable Volume encryption if desired.
Click Deploy On-Demand.

⚠️ CUDA errors when deploying pod¶

Filter CUDA

Deploy in another region.
Change filter to CUDA 12.8 on the RunPod console

📜 Viewing System Logs¶

deployment start

Go to Logs.
Loading takes 9–15 minutes depending on region
If the image doesn’t begin downloading after 1 minute, delete and redeploy in another region.

extracting start

Ends with (example):

Download extracting end

🐳 Viewing Container Logs¶

start container

When you see:

final message

→ Your pod is ready.

⚠️ Hugging Face download takes longer than usual¶

If the Hugging Face download takes longer than usual, restart the pod and try again. Download time still depends on the file size and the speed of the network connection.

🔌 Connecting to Your Pod¶

Docs

Possible http services

⚠️ Not ready – Make sure your service is running! or browser unauthorized error.¶

Unauthorized

Try to connect with the pod-id and the port number to the proxy. You can find the URLs at the end of the log file in the RunPod console.

ComfyUI: https://<pod-id>-8188.proxy.runpod.net/login
Code-Server: https://<pod-id>-9000.proxy.runpod.net/login

🎨 ComfyUI¶

Select tab Connect → ComfyUI
Set username/password
Load a workflow from the left menu.
Press Run
Monitor GPU/RAM via Telemetry

Select Workflow template

⚠️ ComfyUI's screen remains blank¶

Wait one minute and try again.
Restart your browser and/or clear cache.
Try with another browser (brave, chrome, edge).

💻 Web Terminal¶

Web Terminal

Select tab Connect
Enable web terminal
Provides terminal access directly in your browser.

Login without password variable set

No "PASSWORD" set¶

Copy the password displayed at the end of the container log file of the RunPod console or open the web terminal and enter.

cat /root/.config/code-server/config.yaml

Copy the password → log in via the Code-Server service on tab Connect.

"PASSWORD" set as env in RunPod template¶

Log in via the Code-Server service on tab Connect.

Information in pod available¶

Code-Server

⚠️ Code-Server's screen remains blank¶

Wait one minute and try again.
Restart your browser and/or clear cache.
Try with another browser (brave, chrome, edge).

🔐 Secrets¶

Docs

Useful secrets:

PASSWORD
CIVITAI_TOKEN
HF_TOKEN

📥 Downloading Models and LoRAs¶

From web terminal, Code-Server or ComfyUI-Lora-Manager.

🧩 ComfyUI-Lora-Manager¶

Github

Launch web interface¶

top_bar_comfyui

Topbar ComfyUI.
URL displayed at end of container log file.

https://<pod-id>-8188.proxy.runpod.net/loras

Civitai token (needed for download)¶

Go to preferences and add your token if not set before starting the pod (CIVITAI_TOKEN).

top_bar

Press Refresh and Fetch to download images for lora's available in the pod.
Press Download and add the civitai's URL (not download link).

Integration basic¶

Add node Lora-Loader (LoraManager) to your ComfyUI workflow.
Press the Paper Airplane in the Lora-Manager web interface.
Your lora is available in your workflow.

send_lora

lora_loader

🧩 Model linker¶

Tries to link models found in workflows to the provisioning in the pod.
⚠️ Can download models but be aware of the limited volume capacity of the pod.

Example author¶

Video

Example linking models in a ComfyUI template.¶

ml1

ml2

ml3

ml4

ml5

🧩 CivitAI CLI¶

If no "CIVITAI_TOKEN" was set, create or use a free token from the civitai website.

civitai version id

export CIVITAI_TOKEN=“xxxxx”
civitai_com  VERSION_ID /workspace/ComfyUI/models/<loras, etc>
civitai_red  VERSION_ID /workspace/ComfyUI/models/<loras, etc>

civitai_com 2228466 /workspace/ComfyUI/models/loras/
civitai_red 2893442 /workspace/ComfyUI/models/loras/

Refresh

Refresh ComfyUI pressing key r.

☁️ HuggingFace cli¶

"HF_TOKEN" is mandatory but needed for gated sites or upload.

Login:

hf auth login --token xxxxx

or set token:

export HF_TOKEN="xxxxx"

Download example from Huggingface.

hf download ricecake/wan21NSFWClipVisionH_v10 wan21NSFWClipVisionH_v10.safetensors --local-dir /workspace/ComfyUI/models/clip_vision