StreamDeck Docker

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.

Features

• Start/Stop Containers: Control the lifecycle of Docker containers with a single key press.
• Display Container Status: Show the current state (e.g., running, stopped) directly on your Stream Deck keys.
• User-Friendly: Integrates seamlessly with the Stream Deck interface for effortless container management.
• Multi-Container Support: Handles multiple Docker containers simultaneously.
• Start/Stop stack/compose: Control the lifecycle of Docker containers with a single key press.
• Docker Contexts: Select a Docker Context per key. TLS certificates are handled by the Docker Context.

Future improvements

• Enable container deletion using a dial.
• Extend functionality to include more services beyond containers.
• Support remote connections to manage containers.

Prerequisites

Before using this plugin, ensure you have the following installed:

• Elgato Stream Deck Software (latest version)
• Docker (with the Docker Engine API enabled)
• Node.js (for development and building the plugin)

Installation

Get the plugin

Go in Releases section and download the .streamDeckPlugin file from the latest release.

Clone the repository:

git clone https://github.com/Darkdragon14/streamdeck-docker.git

Install the dependencies:

npm install

Build the project:

npm run build

Import the plugin into your Stream Deck software:

Locate the built .streamDeckPlugin file in the dist directory. Double-click it to install the plugin in the Stream Deck software.

Usage

• 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 Context per key. Select default (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.

Development

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
npm i
npm run watch

Contributing

Contributions are welcome! Please submit issues and pull requests to improve the plugin.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

Thanks to Elgato for providing the Stream Deck platform.