Skip to content

Repository files navigation

decky-ssh-toggle

A Decky Loader plugin for the Steam Deck that lets you toggle SSH on and off directly from the Quick Access Menu.

Features

  • Active toggle — start or stop the sshd service immediately
  • Start on boot toggle — enable or disable sshd auto-start via systemctl

Installation

First, install Decky Loader, then enable Developer Mode in the Decky settings (gear icon in the Quick Access Menu).

Install from URL (easiest)

  1. In the Developer section, select Install Plugin from URL.

  2. Enter:

    https://github.com/NeonPimpZ/decky-ssh-toggle/releases/latest/download/decky-ssh-toggle.zip
    
  3. Confirm — the plugin will install and appear under the plug icon.

Install from ZIP

  1. Download decky-ssh-toggle.zip from the latest release onto your Steam Deck.
  2. In the Developer section, select Install Plugin from ZIP and select the downloaded file.
  3. The plugin will install and appear under the plug icon.

Development

Prerequisites

  • Node.js v16.14+ and pnpm v9
  • Docker (for the reproducible build)
sudo npm i -g pnpm@9

Setup

pnpm install

Build

pnpm build          # single build
pnpm watch          # rebuild on file changes
pnpm build:docker   # reproducible build inside Docker

Deploy

Note: SSH must be enabled on your SteamDeck before deploying. Run sudo systemctl start sshd on the Deck manually once. After that you can toggle SSH via the plugin.

Copy the built plugin to your Steam Deck and restart the plugin loader:

pnpm deploy

The deploy script reads connection details from a .env file in the project root. Copy .env.example and fill in your Deck's hostname and username:

cp .env.example .env
DECK_USER=deck
DECK_HOST=steamdeck

About

Decky plugin to toggle SSH on the Steam Deck

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages