Skip to content

Helios Auto Shutdown

Helios Auto Shutdown

Category: Helios Plugin Type: Workstation Add-on Tags: shutdown · desktop · customization

Overview

Helios Auto Shutdown is a Helios workstation add-on that automatically shuts down idle workstations. When the workstation detects that the user has been idle for a configured period, it triggers a clean shutdown — freeing up cluster resources and reducing costs in deployments where workstations should not run unattended indefinitely.

The idle timeout is controlled by the IDLE_TIME environment variable set on the workstation at launch time.

How It Works

Workstation Add-on — When added to a project, this plugin automatically attaches to every Helios workstation launched in that project. No extra steps are needed — install it once and all new Helios workstations will have auto-shutdown behaviour.

Prerequisites

  • Helios workload template installed in the cluster
  • Helios workstations must be launched in the same project where this plugin is installed

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Helios Auto Shutdown"
  3. Click Install
  4. Click Confirm to deploy (no configuration required)

Once installed, the auto-shutdown behaviour will be active for all Helios workstations in the project. Set the IDLE_TIME environment variable when creating workloads in Genesis to control the idle timeout duration.

Configuration

Install-Time Fields

No install-time configuration is required for this plugin.

Runtime Configuration

The shutdown behaviour is controlled via environment variables set on the Helios workload at launch time:

Variable Details
IDLE_TIME Duration of user inactivity before shutdown is triggered (e.g. 30m, 1h)

Notes

  • This plugin is a Helios-specific add-on and has no effect on non-Helios workloads
  • The IDLE_TIME value is set in the workload's environment variables in Genesis at launch time
  • Shutdown is clean — the workstation saves state and stops gracefully rather than being force-killed
plugins/helios-auto-shutdown/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
resource_id: helios-auto-shutdown
name: Helios Auto Shutdown
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/helios/scripts/assets/helios-icon.png
description: Triggers auto-shutdown of Helios workstations via Kuiper when running in a Juno deployment. To set the shutdown time, use the IDLE_TIME environment variable in the workstation template.
category: Helios Plugin
tags:
    - shutdown
    - desktop
    - customization
fields: []