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.

Web server Docker LAN / mobile
1

Install the prerequisites

You'll need Docker, Compose, and an NVIDIA GPU with the container toolkit. The supplied image targets NVIDIA CUDA, and the compose file reserves the GPU.

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

Exposes your NVIDIA GPU to the container. The supplied compose file reserves one. 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

Set the admin account

The included docker-compose.yml reads its settings from a .env file. Copy the example, then set the admin user and a strong password. The container refuses to start while the password is empty or changeme.

Terminal
$ cp .env.example .env
.env
MOOSHIEUI_PORT=3200
MOOSHIEUI_ADMIN_USER=admin
MOOSHIEUI_ADMIN_PASS=<a strong password>

MOOSHIEUI_PORT is the port the web UI is published on. Models are read from ./models on the host (change it with MODELS_PATH). The container runs as user 10001, so that folder must be writable by it.

Terminal
$ sudo chown -R 10001:10001 ./models
4

Bring the stack up

Build and start the server in the background. The image ships ComfyUI, PyTorch, and MooshieUI's custom nodes pre-installed, so there is no setup wizard to run.

Terminal
$ docker compose up -d --build
Heads up: the first build downloads several GB (the CUDA base image, PyTorch, and ComfyUI). Settings, accounts, and galleries live in the mooshie-data volume and models in ./models, so both survive rebuilds.
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, and sign in with the admin account you set. The UI is responsive down to phone screens.

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