joly0/pinokio-docker repository overview

⁠pinokio-docker

Source and issues: github.com/Joly0/pinokio-docker⁠

Pinokio⁠ in a container, accessible from any web browser.

Pinokio is a 1-click launcher for open-source AI apps: browse, install, run and manage tools like Stable Diffusion WebUIs, ComfyUI, LLM front ends or voice cloning without touching a terminal. This image runs the Pinokio desktop app on a Linux desktop that is streamed to your browser, so you can host it on a server (Unraid, a NAS, a home lab box) and use it from anywhere on your network.

⁠Features

• Pinokio in the browser: the desktop app runs on linuxserver.io's Selkies base image⁠ and is streamed to the browser over HTTP and HTTPS
• Always up to date: new Pinokio releases are picked up automatically within a few hours, and the image is rebuilt weekly for base image and security updates
• Persistent data: everything (Pinokio home, installed apps, models, settings) lives in /config
• Configurable through environment variables: any PINOKIO_* variable is written into Pinokio's own settings on first start
• Local network sharing: apps started in Pinokio can be reached from other devices through a fixed port
• Self-healing: Pinokio is restarted automatically if it crashes or is closed

⁠Quick start

⁠docker run

docker run -d \
  --name=pinokio \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 3000:3000 \
  -p 3001:3001 \
  -p 50000:50000 \
  -v /path/to/config:/config \
  --shm-size=1gb \
  --security-opt seccomp=unconfined \
  --restart unless-stopped \
  joly0/pinokio-docker:latest

⁠docker compose

services:
  pinokio:
    image: joly0/pinokio-docker:latest
    container_name: pinokio
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
      - 50000:50000
    shm_size: "1gb"
    security_opt:
      - seccomp:unconfined
    restart: unless-stopped

Then open https://yourhost:3001/⁠ (or http://yourhost:3000/⁠) in your browser. Pinokio starts maximised in the streamed desktop.

⁠Parameters

⁠Pinokio settings

Pinokio keeps its settings in /config/pinokio/ENVIRONMENT. Any environment variable starting with PINOKIO_ that matches a key in that file is written into it once Pinokio has created the file on first start. Each key is only applied once: changes you make later in the Pinokio settings are kept across restarts, and a key is never overwritten again. To reapply a variable, remove its line from /config/pinokio/.pinokio_env_applied.

All other keys in the ENVIRONMENT file work the same way, see the comments in that file for what each one does.

⁠Desktop options

The Selkies base image⁠ offers further options, for example:

See the Selkies configuration docs⁠ for the full list, including GPU acceleration⁠.

⁠Image tags

Images are published to Docker Hub⁠ and the GitHub Container Registry⁠ as joly0/pinokio-docker and ghcr.io/joly0/pinokio-docker.

Only linux/amd64 is built.

⁠Building locally

git clone https://github.com/Joly0/pinokio-docker.git
cd pinokio-docker
docker build -t pinokio-docker .

The build installs the newest Pinokio release. Pass --build-arg PINOKIO_VERSION=<release tag> to build a specific one.

⁠Support

Bugs and feature requests go to the issue tracker⁠. Problems with Pinokio itself (rather than with the container) belong in the Pinokio repository⁠.

⁠License

AGPL-3.0⁠. Pinokio itself is developed by pinokiocomputer⁠ under its own license.