citron

2026.02.1-2-ls17deprecated

Citron is a feature rich Switch 1 emulator for homebrew.

Games

docker pull lscr.io/linuxserver/citron:latest

This image is deprecated

It is no longer maintained and receives no further updates. The details below are kept for reference; you can find maintained alternatives in the catalogue.

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

---
services:
  citron:
    image: lscr.io/linuxserver/citron:latest
    container_name: citron
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: 1gb
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
3000:3000	Citron desktop gui HTTP must be proxied.	required
3001:3001	Citron desktop gui HTTPS.	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required

Volumes
Path	Function	Required
/config	Users home directory in the container, stores local files and settings	required

Other settings
Setting	Function	Required
shm_size: 1gb	Recommended for all desktop images.	required

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64latest

Changelog

20 Dec 2025
Add Wayland init logic.
24 Nov 2025
Initial Version.

Browse all

dolphin

2609a-ls87

Dolphin Emulator lets you play GameCube and Wii games with various graphical enhancements and other features are available to improve your game experience.

2.8M13

webstation

ceb22cc0-ls41

Webstation is a web native emulation focused LXQt desktop based on Ubuntu.

78.6K15

luanti

5.18.0-rc1-ls50

luanti (formerly Minetest) is an open source voxel game-creation platform with easy modding and game creation

36.1K15arm64

steam

95181c2e-ls45

Steam is the ultimate destination for playing, discussing, and creating games.

21.4K36