Some prebuild docker images https://hub.docker.com/repository/docker/liutyi/sdnext-ipex/general
See generation examples for all models https://vladmandic.github.io/sd-samples/compare.html
SD.Next openvino setup for Intel Core i7 1355U with Intel Xe iGPU
git clone https://github.com/vladmandic/sdnext cd sdnext/ ./webui.sh --update --insecure --listen --use-openvino |
SD.Next IPEX setup for Intel Core Ultra 9 185H Intel Arc iGPU
https://github.com/vladmandic/sdnext/wiki/Intel-ARC
services:
sdnext-ipex:
image: liutyi/sdnext-ipex:25.9.1-igpu
container_name: sdnext-ipex
restart: unless-stopped
devices:
- /dev/dri:/dev/dri
- /dev/accel:/dev/accel
environment:
- HF_DEBUG=True
ports:
- 7860:7860
volumes:
- /docker/sdnext/app-volume:/app
- /docker/sdnext/mnt-volume:/mnt
- /docker/sdnext/hf-volume:/root/.cache/huggingface
- /dev/shm:/dev/shm |
proxy is sometimes needed to access Intel video drivers repository. so 'https_proxy=http://proxy.example.com:18080/' to be replaced with working one or removed
# SD.Next IPEX Dockerfile
# docs: <https://github.com/vladmandic/sdnext/wiki/Docker>
# base image
FROM ubuntu:noble
# metadata
LABEL org.opencontainers.image.vendor="SD.Next"
LABEL org.opencontainers.image.authors="liutyi"
LABEL org.opencontainers.image.url="https://github.com/liutyi/sdnext/"
LABEL org.opencontainers.image.documentation="https://github.com/vladmandic/sdnext/wiki/Docker"
LABEL org.opencontainers.image.source="https://github.com/vladmandic/sdnext/"
LABEL org.opencontainers.image.licenses="AGPL-3.0"
LABEL org.opencontainers.image.title="SD.Next IPEX"
LABEL org.opencontainers.image.description="SD.Next: Advanced Implementation of Stable Diffusion and other Diffusion-based generative image models"
LABEL org.opencontainers.image.base.name="https://hub.docker.com/_/ubuntu:noble"
LABEL org.opencontainers.image.version="25.9.0"
# essentials
RUN apt-get update && \
apt-get install -y --no-install-recommends --fix-missing \
software-properties-common \
build-essential \
ca-certificates \
wget \
gpg \
git \
libgomp1 \
libtbb12
# NPU
RUN wget https://github.com/intel/linux-npu-driver/releases/download/v1.23.0/linux-npu-driver-v1.23.0.20250827-17270089246-ubuntu2404.tar.gz &&\
tar -xf linux-npu-driver-v1.23.0.20250827-17270089246-ubuntu2404.tar.gz &&\
dpkg -i *.deb &&\
rm -f linux-npu-driver-v1.23.0.20250827-17270089246-ubuntu2404.tar.gz intel-*
# required by pytorch / ipex
RUN apt-get install -y --no-install-recommends --fix-missing \
libgl1 \
libglib2.0-0
# python3.12
RUN apt-get install -y --no-install-recommends --fix-missing \
python3 \
python3-dev \
python3-venv \
python3-pip
# intel compute runtime
RUN add-apt-repository ppa:kobuk-team/intel-graphics
RUN apt-get update
RUN apt-get install -y --no-install-recommends --fix-missing \
intel-opencl-icd \
libze-intel-gpu1 \
libze1
# cleanup
RUN /usr/sbin/ldconfig
RUN apt-get clean && rm -rf /var/lib/apt/lists/*
# set paths to use with sdnext
ENV SD_DOCKER=true
ENV SD_VAE_DEBUG=true
ENV SD_DATADIR="/mnt/data"
ENV SD_MODELSDIR="/mnt/models"
ENV venv_dir="/mnt/python/venv"
ENV IPEX_SDPA_SLICE_TRIGGER_RATE=1
ENV IPEX_ATTENTION_SLICE_RATE=0.5
ENV IPEX_FORCE_ATTENTION_SLICE=1
ENV IPEXRUN=True
# git clone and run sdnext
# RUN echo '#!/bin/bash\ngit status || git clone https://github.com/vladmandic/sdnext.git -b dev .\n/app/webui.sh "$@"' | tee /bin/startup.sh
RUN echo '#!/bin/bash\ngit status || git clone https://github.com/liutyi/sdnext.git -b ipex .\n/app/webui.sh "$@"' | tee /bin/startup.sh
RUN chmod 755 /bin/startup.sh
# actually run sdnext
WORKDIR /app
ENTRYPOINT [ "startup.sh", "-f", "--use-ipex", "--uv", "--listen", "--insecure", "--api-log", "--log", "sdnext.log" ]
# expose port
EXPOSE 7860
# healthcheck function
#HEALTHCHECK --interval=60s --timeout=10s --start-period=60s --retries=3 CMD curl --fail http://localhost:7860/sdapi/v1/status || exit 1
# stop signal
STOPSIGNAL SIGINT |
docker compose up -d docker compose down --rmi local |
/etc/nginx/sites-enabled/sdnext.conf
server {
listen 80;
server_name sdnext.example.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl;
server_name sdnext.example.com;
# SSL Settings
ssl_certificate /etc/ssl/private/wildcard.pem;
ssl_certificate_key /etc/ssl/private/wildcard.pem;
ssl_trusted_certificate "/etc/ssl/certs/wildcard.ca";
add_header Strict-Transport-Security 'max-age=15552000; includeSubDomains';
ssl_protocols TLSv1.3 TLSv1.2;
ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA+RC4 EECDH EDH+aRSA HIGH !RC4 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS";
ssl_session_cache shared:SSL:20m;
ssl_session_timeout 1h;
ssl_prefer_server_ciphers on;
ssl_stapling on;
ssl_stapling_verify on;
# Timeouts
client_max_body_size 50G;
client_body_timeout 600s;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
send_timeout 600s;
# Set headers
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# enable websockets
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_redirect off;
# DNS
resolver 1.1.1.1 8.8.4.4 valid=300s;
resolver_timeout 5s;
location /file=/mnt/data {
alias /docker/sdnext/mnt-volume/data;
}
location / {
proxy_pass http://127.0.0.1:7860;
}
}
|
/docker/sdnext/mnt-volume/data/config.json
{
"sd_model_checkpoint": "Diffusers/imnotednamode/Chroma-v36-dc-diffusers [38ce7ce7f3]",
"outdir_txt2img_samples": "/mnt/data/outputs/text",
"outdir_img2img_samples": "/mnt/data/outputs/image",
"outdir_control_samples": "/mnt/data/outputs/control",
"outdir_extras_samples": "/mnt/data/outputs/extras",
"outdir_save": "/mnt/data/outputs/save",
"outdir_video": "/mnt/data/outputs/video",
"outdir_init_images": "/mnt/data/outputs/init-images",
"outdir_txt2img_grids": "/mnt/data/outputs/grids",
"outdir_img2img_grids": "/mnt/data/outputs/grids",
"outdir_control_grids": "/mnt/data/outputs/grids",
"diffusers_version": "8adc6003ba4dbf5b61bb4f1ce571e9e55e145a99",
"sd_checkpoint_hash": null,
"huggingface_token": "hf_PUT-HERE-YOUR-HuggingFace-Token",
"samples_filename_pattern": "[seq]-[date]-[model_name]-[width]x[height]-STEP[steps]-CFG[cfg]-Seed[seed]"
} |
ui config
/docker/sdnext/mnt-volume/data/ui-config.json
{} |
https://huggingface.co/settings/tokens
https://huggingface.co/meta-llama/Llama-3.1-8B-Instruct
https://huggingface.co/meta-llama/Llama-3.3-70B-Instruct
https://huggingface.co/stabilityai/stable-diffusion-3.5-large
https://huggingface.co/black-forest-labs/FLUX.1-dev
In case you got repo access, enter tokens to WebUI and still got error like
2025-06-20 13:25:36,995 | 97698f11112d | sd | ERROR | sd_models | Load model: path="/mnt/models/Diffusers/models--HiDream-ai--HiDream-I1-Dev/snapshots/5b3f48f0d64d039cd5e4b6bd47b4f4e0cbebae 62" 401 Client Error. (Request ID: Root=1-68556150-3f4018045ca5c71e00c09f88;3ae0ae6d-465e-46ed-9934-c5ea6af2097d) Cannot access gated repo for url https://huggingface.co/api/models/meta-llama/Meta-Llama-3.1-8B-Instruct/auth-check. Access to model meta-llama/Llama-3.1-8B-Instruct is restricted. You must have access to it and be authenticated to access it. Please log in. 2025-06-20 13:25:37,786 | 97698f11112d | sd | ERROR | sd_models | StableDiffusionPipeline: Pipeline <class 'diffusers.pipelines.stable_diffusion.pipeline_stable_diffusion.StableDiffusionPipeline'> expected ['feature_extractor', 'image_encoder', |
workaround is to login manually
docker exec -it sdnext-ipex bash |
inside the container
export venv_dir=/mnt/python/venv/
source "${venv_dir}"/bin/activate
/mnt/python/venv/bin/huggingface-cli login |
(venv) root@97698f11112d:/app# /mnt/python/venv/bin/huggingface-cli login
_| _| _| _| _|_|_| _|_|_| _|_|_| _| _| _|_|_| _|_|_|_| _|_| _|_|_| _|_|_|_|
_| _| _| _| _| _| _| _|_| _| _| _| _| _| _| _|
_|_|_|_| _| _| _| _|_| _| _|_| _| _| _| _| _| _|_| _|_|_| _|_|_|_| _| _|_|_|
_| _| _| _| _| _| _| _| _| _| _|_| _| _| _| _| _| _| _|
_| _| _|_| _|_|_| _|_|_| _|_|_| _| _| _|_|_| _| _| _| _|_|_| _|_|_|_|
A token is already saved on your machine. Run `huggingface-cli whoami` to get more information or `huggingface-cli logout` if you want to log out.
Setting a new token will erase the existing one.
To log in, `huggingface_hub` requires a token generated from https://huggingface.co/settings/tokens .
Enter your token (input will not be visible): PUT HERE YOUR hf_.............
Add token as git credential? (Y/n) y
Token is valid (permission: write).
The token `SDNext` has been saved to /root/.cache/huggingface/stored_tokens
Cannot authenticate through git-credential as no helper is defined on your machine.
You might have to re-authenticate when pushing to the Hugging Face Hub.
Run the following command in your terminal in case you want to set the 'store' credential helper as default.
git config --global credential.helper store
Read https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage for more details.
Token has not been saved to git credential helper.
Your token has been saved to /root/.cache/huggingface/token
Login successful.
The current active token is: `SDNext` |
First start console output example
sdnext-ipex | fatal: not a git repository (or any parent up to mount point /)
sdnext-ipex | Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
sdnext-ipex | Cloning into '.'...
sdnext-ipex | 09:39:20-590857 INFO Starting SD.Next
sdnext-ipex | 09:39:20-592353 INFO Logger: file="/app/sdnext.log" level=INFO
sdnext-ipex | host="a7e3c88ab9d3" size=79 mode=append
sdnext-ipex | 09:39:20-592961 INFO Python: version=3.12.3 platform=Linux
sdnext-ipex | bin="/mnt/python/venv/bin/python3"
sdnext-ipex | venv="/mnt/python/venv"
sdnext-ipex | 09:39:20-608102 INFO Version: app=sd.next updated=2025-07-22 hash=bf6ba074
sdnext-ipex | branch=dev
sdnext-ipex | url=https://github.com/vladmandic/sdnext.git/tree/dev
sdnext-ipex | ui=dev
sdnext-ipex | 09:39:20-983435 INFO Version: app=sd.next latest=2025-07-22T17:45:09Z
sdnext-ipex | hash=bf6ba074 branch=dev
sdnext-ipex | 09:39:20-986261 INFO Platform: arch=x86_64 cpu=x86_64 system=Linux
sdnext-ipex | release=6.14.0-24-generic python=3.12.3 locale=('C',
sdnext-ipex | 'UTF-8') docker=True
sdnext-ipex | 09:39:20-987344 INFO Args: ['-f', '--use-ipex', '--uv', '--listen',
sdnext-ipex | '--insecure', '--server-name sdnext.liutyi.info',
sdnext-ipex | '--update', '--api-log', '--log', 'sdnext.log']
sdnext-ipex | 09:39:28-794452 INFO Verifying torch installation
sdnext-ipex | 09:39:28-800305 INFO IPEX: Intel OneAPI toolkit detected
sdnext-ipex | 09:39:28-800813 INFO Torch: download and install in progress...
sdnext-ipex | cmd="torch==2.7.1+xpu torchvision==0.22.1+xpu
sdnext-ipex | --index-url https://download.pytorch.org/whl/xpu"
sdnext-ipex | 09:39:47-250742 INFO Transformers install: version=4.53.2
sdnext-ipex | 09:39:54-002845 INFO Diffusers install:
sdnext-ipex | commit=9c13f8657986e68f5f05987912c54432fd28d86f
sdnext-ipex | 09:40:03-379010 INFO Install: verifying requirements
sdnext-ipex | 09:40:20-543998 WARNING Install: package="requests" installed=2.32.3
sdnext-ipex | required=2.32.4 version mismatch
sdnext-ipex | 09:40:24-323953 WARNING Install: package="numpy" installed=2.3.1 required=2.1.2
sdnext-ipex | version mismatch
sdnext-ipex | 09:40:27-824620 WARNING Install: package="protobuf" installed=6.31.1
sdnext-ipex | required=4.25.3 version mismatch
sdnext-ipex | 09:40:29-215550 WARNING Install: package="urllib3" installed=2.5.0
sdnext-ipex | required=1.26.19 version mismatch
sdnext-ipex | 09:40:29-578491 WARNING Install: package="Pillow" installed=11.3.0
sdnext-ipex | required=10.4.0 version mismatch
sdnext-ipex | 09:40:31-005080 WARNING Install: package="pydantic" installed=2.11.7
sdnext-ipex | required=1.10.21 version mismatch
sdnext-ipex | 09:40:32-101413 WARNING Install: package="scipy" installed=1.16.0
sdnext-ipex | required=1.14.1 version mismatch
sdnext-ipex | 09:40:40-957425 INFO Startup: standard
sdnext-ipex | 09:40:40-957983 INFO Verifying submodules
sdnext-ipex | 09:41:02-944419 INFO Extension installed packages:
sdnext-ipex | stable-diffusion-webui-rembg
sdnext-ipex | ['opencv-python-headless==4.12.0.88', 'pooch==1.8.2',
sdnext-ipex | 'pymatting==1.1.14', 'rembg==2.0.67']
sdnext-ipex | 09:41:02-945357 INFO Extensions enabled: ['sd-extension-chainner',
sdnext-ipex | 'sd-extension-system-info', 'sd-webui-agent-scheduler',
sdnext-ipex | 'sdnext-modernui', 'stable-diffusion-webui-rembg']
sdnext-ipex | 09:41:02-956589 INFO Install: verifying requirements
sdnext-ipex | 09:41:02-958641 INFO Updating Wiki
sdnext-ipex | 09:41:03-382695 INFO Installer time: total=280.95 pip=85.95 install=71.04
sdnext-ipex | requirements=34.48 git=19.32 submodules=16.73
sdnext-ipex | torch=16.03 diffusers=8.80 transformers=6.75
sdnext-ipex | update=5.05 base=4.91 stable-diffusion-webui-rembg=3.50
sdnext-ipex | packages=3.12 onnx=2.42 sd-extension-chainner=0.46
sdnext-ipex | sd-extension-system-info=0.44
sdnext-ipex | sd-webui-agent-scheduler=0.43 wiki=0.42
sdnext-ipex | sdnext-modernui=0.42 latest=0.39 branch=0.15 files=0.09
sdnext-ipex | 09:41:03-384464 INFO Command line args: ['-f', '--use-ipex', '--uv',
sdnext-ipex | '--listen', '--insecure', '--server-name
sdnext-ipex | sdnext.liutyi.info', '--update', '--api-log', '--log',
sdnext-ipex | 'sdnext.log'] insecure=True listen=True f=True
sdnext-ipex | upgrade=True uv=True use_ipex=True log=sdnext.log
sdnext-ipex | api_log=True args=['--server-name sdnext.liutyi.info']
sdnext-ipex | 09:41:11-889139 INFO Torch: torch==2.7.1+xpu torchvision==0.22.1+xpu
sdnext-ipex | 09:41:11-891191 INFO Packages: diffusers==0.35.0.dev0 transformers==4.53.2
sdnext-ipex | accelerate==1.9.0 gradio==3.43.2 pydantic==1.10.21
sdnext-ipex | numpy==2.1.2
sdnext-ipex | 09:41:12-407124 INFO Device detect: memory=125.3 default=balanced
sdnext-ipex | 09:41:12-412036 INFO Engine: backend=Backend.DIFFUSERS compute=ipex
sdnext-ipex | device=xpu attention="Scaled-Dot-Product" mode=no_grad
sdnext-ipex | 09:41:12-916299 INFO Torch parameters: backend=ipex device=xpu config=Auto
sdnext-ipex | dtype=torch.bfloat16 context=no_grad nohalf=False
sdnext-ipex | nohalfvae=False upcast=False deterministic=False
sdnext-ipex | tunable=[False, False] fp16=pass bf16=pass
sdnext-ipex | optimization="Scaled-Dot-Product"
sdnext-ipex | 09:41:12-917422 INFO Device: device=Intel(R) Arc(TM) Graphics n=1 ipex=
sdnext-ipex | driver=1.6.31294+20
sdnext-ipex | 09:41:13-000978 TRACE Trace: VAE
sdnext-ipex | 09:41:13-079977 INFO Base path: data="/mnt/data"
sdnext-ipex | 09:41:13-080481 INFO Base path: models="/mnt/models"
sdnext-ipex | 09:41:13-128374 INFO Available VAEs: path="/mnt/models/VAE" items=0
sdnext-ipex | 09:41:13-129122 INFO Available UNets: path="/mnt/models/UNET" items=0
sdnext-ipex | 09:41:13-129636 INFO Available TEs: path="/mnt/models/Text-encoder" items=0
sdnext-ipex | 09:41:13-131256 INFO Available Models:
sdnext-ipex | safetensors="/mnt/models/Stable-diffusion":5
sdnext-ipex | diffusers="/mnt/models/Diffusers":33 items=38 time=0.00
sdnext-ipex | 09:41:13-142003 INFO Available LoRAs: path="/mnt/models/Lora" items=0
sdnext-ipex | folders=2 time=0.00
sdnext-ipex | 09:41:13-146684 INFO Available Styles: path="/mnt/models/styles" items=288
sdnext-ipex | time=0.00
sdnext-ipex | 09:41:23-911055 INFO Available Detailer: path="/mnt/models/yolo" items=11
sdnext-ipex | downloaded=0
sdnext-ipex | 09:41:23-912038 INFO Load extensions
sdnext-ipex | 09:41:25-419079 INFO Extension:
sdnext-ipex | script='extensions-builtin/sd-webui-agent-scheduler/scr
sdnext-ipex | ipts/task_scheduler.py' Using sqlite file:
sdnext-ipex | extensions-builtin/sd-webui-agent-scheduler/task_schedu
sdnext-ipex | ler.sqlite3
sdnext-ipex | 09:41:25-441239 INFO Available Upscalers: items=72 downloaded=0 user=0
sdnext-ipex | time=0.02 types=['None', 'Resize', 'Latent',
sdnext-ipex | 'AsymmetricVAE', 'DCC', 'VIPS', 'ChaiNNer', 'AuraSR',
sdnext-ipex | 'ESRGAN', 'RealESRGAN', 'SCUNet', 'Diffusion',
sdnext-ipex | 'SwinIR']
sdnext-ipex | 09:41:25-450058 INFO UI locale: name="Auto"
sdnext-ipex | 09:41:25-450541 INFO UI theme: type=Standard name="black-teal" available=13
sdnext-ipex | 09:41:26-915157 INFO Extension list is empty: refresh required
sdnext-ipex | 09:41:27-137364 INFO Local URL: http://localhost:7860/
sdnext-ipex | 09:41:27-137947 WARNING Public URL: enabled without authentication
sdnext-ipex | 09:41:27-138350 WARNING Public URL: enabled with insecure flag
sdnext-ipex | 09:41:27-138779 INFO External URL: http://172.21.0.3:7860
sdnext-ipex | 09:41:27-318564 INFO Public URL: http://xx.xx.xx.xx:7860
sdnext-ipex | 09:41:27-743268 INFO [AgentScheduler] Task queue is empty
sdnext-ipex | 09:41:27-743982 INFO [AgentScheduler] Registering APIs
sdnext-ipex | 09:41:30-738759 INFO Startup time: total=350.54 launch=108.02 numpy=107.87
sdnext-ipex | installer=107.73 detailer=10.76 torch=6.36
sdnext-ipex | checkpoint=2.91 extensions=1.51 libraries=1.50
sdnext-ipex | gradio=1.44 app-started=0.44 ui-extensions=0.34
sdnext-ipex | ui-gallery=0.23 ui-models=0.22 ui-control=0.19
sdnext-ipex | ui-networks=0.17 bnb=0.16 ui-txt2img=0.12
sdnext-ipex | ui-img2img=0.11 ui-video=0.07 diffusers=0.07 api=0.07
sdnext-ipex | ui-defaults=0.07
|