zero-desktop-kiosk

Launch a single application in kiosk mode.

What is this?

Like an ATM interface: users only see your specific application, nothing else. No desktop, no menu, no taskbar.

Perfect for:

• Web kiosks (browser only)
• Digital signage
• Product demos
• Public terminals
• Restricted environments

Quick Start

Terminal Kiosk

docker run -d \
  -p 6080:6080 \
  -e VNC_PASS=yourpassword \
ghcr.io/zero-desktop/zero-desktop-kiosk:latest

Opens xterm with instructions. Install your app first (see below).

Web Kiosk (After Installing Browser)

First install browser, then use:

docker run -d \
  -p 6080:6080 \
  -e VNC_PASS=yourpassword \
  -e APP_COMMAND="chromium --kiosk https://your-site.com" \
ghcr.io/zero-desktop/zero-desktop-kiosk:latest

Open browser: http://localhost:6080 → Only sees your website

Custom Application

docker run -d \
  -p 6080:6080 \
  -e VNC_PASS=yourpassword \
  -e APP_COMMAND="libreoffice --writer" \
ghcr.io/zero-desktop/zero-desktop-kiosk:latest

Environment

Variable	Default	Description
APP_COMMAND	Required	Command to launch your application
SYSTEM_USER	docker	Linux user
VNC_PASS	Required	VNC password
RESOLUTION	1280x720	Screen resolution

Examples

Web Application

A simple web application:

services:
  webapp:
    image: ghcr.io/zero-desktop/zero-desktop-kiosk:latest
    ports:
      - "6080:6080"
    environment:
      - APP_COMMAND=chromium --kiosk https://app.example.com
      - VNC_PASS=kiosk123
      - RESOLUTION=1920x1080

Custom App with Fullscreen

An app on fullscreen, without desktop:

services:
  myapp:
    image: ghcr.io/zero-desktop/zero-desktop-kiosk:latest
    ports:
      - "6080:6080"
    environment:
      - APP_COMMAND=myapp --fullscreen
      - VNC_PASS=secure123
    volumes:
      - ./myapp:/usr/local/bin/myapp

Kiosk Options

Browser Kiosk Flags

Firefox:

firefox-esr --kiosk URL

Chromium:

chromium --kiosk --disable-infobars --no-first-run URL

Application Fullscreen

Most apps support:

myapp --fullscreen
myapp -f
myapp --kiosk

License

Apache License 2.0 - See LICENSE file for details.

Copyright 2024-2025 zero-desktop organization and José Meira (jmeiracorbal)