A powerful plugin for Elgato Stream Deck that allows you to manage Docker containers directly from your Stream Deck. With this tool, you can start, stop, and monitor Docker containers with ease, all while keeping your workflow streamlined.
- Start/Stop Containers: Control Docker container lifecycle with a single key press.
- Display Container Status: Show the current state (for example, running or stopped) directly on your Stream Deck keys.
- User-Friendly Interface: Integrates seamlessly with Stream Deck for effortless container management.
- Multi-Container Support: Manage multiple Docker containers simultaneously.
- Stack Start/Stop: Control an entire Docker Compose stack with a single key press.
- Running Stack Stop: Automatically bind a key to a running stack and stop it when pressed.
- Docker Stack Select and Toggle: Use a Stream Deck + dial to browse stacks and start or stop the selected stack.
- Fast Stack Refresh: Refresh running stacks every 10 seconds.
- Docker Context Support: Select a Docker Context per key. TLS certificates are handled by the Docker Context.
- Enable container deletion using a dial.
- Extend functionality to include more services beyond containers.
- Support remote connections to manage containers.
Before using this plugin, ensure you have the following installed:
- Elgato Stream Deck Software 7.1 or newer (latest version recommended)
- Docker (with the Docker Engine API enabled)
- Node.js 24.22.1 or newer within the 24.x line (for development and building the plugin)
Development and CI use the patched Node.js version pinned in .nvmrc. Node.js 24.22.1 addresses the October 2026 security advisory. npm rejects unsupported Node.js versions via engines and .npmrc.
The installed plugin uses Stream Deck's bundled Node.js 24 runtime, not the Node.js installed on your system. Stream Deck 7.1 introduced Node.js 24 support, but this minimum version alone does not guarantee the security fixes: keep Stream Deck updated and verify that its bundled Node.js 24 runtime is at least 24.22.1. The plugin manifest selects only the Node.js major version; it cannot pin a security patch. Updating npm dependencies or your system Node.js does not update this bundled runtime.
The dependency override for @elgato/utils@0.4.1 pins patched Zod 4.6.7 to address GHSA-mrhx-c7xc-m3w5. The current Elgato dependency declares Zod 3.25 but imports its bundled Zod 4 Mini API (zod/v4-mini), which the patched version also exports. npm test checks RPC schema compatibility and built-plugin registration. Reassess the override when Elgato ships a dependency range that includes patched Zod.
Install it from the Elgato Marketplace.
Or go in the Releases section and download the .streamDeckPlugin file from the latest release.
git clone https://github.com/Darkdragon14/streamdeck-docker.gitSelect the project's Node.js version with nvm (or install the version from .nvmrc using your preferred version manager):
nvm install
nvm use
npm cinpm run buildLocate the built .streamDeckPlugin file in the dist directory. Double-click it to install the plugin in the Stream Deck software.
- Open the Stream Deck software.
- Drag a Docker action to a key.
- Optional: set the
Remote (optional)field to target a remote Docker (leave empty for local; ensures backward compatibility). - Preferred: pick a
Contextper key. Selectdefault (local)to use the local Docker; choose a named Docker Context to target a remote. - Configure the action-specific fields (container, stack, image, etc.).
- Press the key to start/stop or query status.
To contribute or modify the plugin, follow these steps:
Clone the repository and navigate to the project directory:
git clone https://github.com/Darkdragon14/streamdeck-docker.git
cd streamdeck-docker
nvm install
nvm use
npm ci
npm run watchContributions are welcome! Please submit issues and pull requests to improve the plugin.
This project is licensed under the MIT License. See the LICENSE file for details.
Thanks to Elgato for providing the Stream Deck platform.