Docker guide

Self-host MooshieUI with Docker

Run the built-in web server in a container and reach the same interface from any device on your network: desktop, laptop, or phone. One file, one command.

Web server Docker LAN / mobile
1

Install the prerequisites

You'll need Docker and Compose. For GPU-accelerated generation on an NVIDIA card, add the container toolkit. CPU-only works too, just slower.

Docker Engine

Runs the container. Desktop or CLI both work. get Docker

Docker Compose v2

Ships with recent Docker. Brings the stack up in one command. Compose docs

NVIDIA Container Toolkit

Optional. Exposes your GPU to the container for fast generation. toolkit setup

2

Clone the repository

The compose file lives in the repo. Grab the source and move into it.

Terminal
$ git clone https://github.com/Mooshieblob1/MooshieUI.git
$ cd MooshieUI
3

Configure the compose file

A starter docker-compose.yml is included. Mount a host folder for your models and outputs so they survive container rebuilds, and pick the port you want to serve on.

docker-compose.yml
$ services:
$   mooshieui:
$     image: ghcr.io/mooshieblob1/mooshieui:latest
$     ports: ["8188:8188"]
$     volumes: ["./data:/app/data"]
4

Bring the stack up

Build and start the server in the background. The first launch pulls the image and runs the same setup wizard that installs ComfyUI and PyTorch into the mounted data volume.

Terminal
$ docker compose up -d
Heads up: first-time setup downloads ~5–10 GB (Python + PyTorch + ComfyUI) into the ./data volume. Keep that folder around; subsequent starts are near-instant.
5

Open it anywhere on your network

Browse to the server from the host machine, then reach it from any other device on your LAN using the host's IP address. The UI is responsive down to phone screens.

Browser
$ http://localhost:8188
$ http://192.168.1.20:8188
Want a native window instead? Build the desktop app from source. The interface is identical either way.