Install the RipDock Hermes Plugin

The RipDock Hermes plugin lets Hermes expose Runtime identity, Agent metadata, Pairing, Sessions, chat, and file transfer support to the RipDock App.

Option 1: Git Command

On the server where Hermes is installed, clone the public RipDock Hermes plugin into your Hermes plugins directory. 

ssh user@your-server
mkdir -p ~/.hermes/plugins
git clone https://github.com/RipDock/ripdock-hermes-plugin.git ~/.hermes/plugins/ripdock

After installing, restart the dashboard.

Option 2: HTTP Download

If Git is not installed on your server, download the plugin archive and unpack it into the same folder. 

ssh user@your-server
mkdir -p ~/.hermes/plugins/ripdock
curl -L https://github.com/RipDock/ripdock-hermes-plugin/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=1 -C ~/.hermes/plugins/ripdock

After installing, restart the dashboard.

Option 3: Dashboard Install from GitHub

Open the Hermes dashboard, choose Plugins, and use Install From GitHub / Git URL. Enter the repository, turn on Enable after install, then install. 

ripdock/ripdock-hermes-plugin

After installing, restart the dashboard.

Plugin Directory

If your Hermes installation uses a different plugins directory, clone the plugin into that directory instead. The installed plugin folder should be named ripdock.

Restart the Dashboard

After installing or enabling the plugin, restart the Hermes dashboard so its API routes are loaded. 

pkill -f "hermes dashboard" || true
nohup hermes dashboard --no-open --host 127.0.0.1 --port 9119 > ~/.hermes/dashboard.log 2>&1 &

Restart the Gateway

Restart the Hermes gateway so it reloads the enabled RipDock plugin. 

hermes gateway restart
hermes gateway status

Confirm Plugin Load

  1. Reload the Hermes dashboard in your browser.
  2. If the RipDock plugin is inactive, click Enable.
  3. Confirm the RipDock plugin appears.
  4. Confirm Gateway Status: Running appears in the sidebar.
  5. Confirm the RipDock plugin page shows Runtime Connected.

Next: set up your public HTTPS Runtime URL.