Install Hermes

Hermes is the Runtime that RipDock beta connects to. Install Hermes first, then add the RipDock Hermes plugin.

Install and Start Hermes

1. Install Hermes using the installation method for your Hermes distribution.
2. Start Hermes.
3. Open the Hermes dashboard in your browser.
4. Confirm Hermes is running before continuing.

Example VPS Installation

Connect to your virtual server, run the Hermes installer, enable user services for headless operation, then install and start the Hermes gateway service.

ssh <user>@<your-server>
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc   # or: source ~/.zshrc
sudo loginctl enable-linger <user>
hermes gateway install
hermes gateway start
hermes gateway status

The linger command allows user services to run after logout and across reboots. The gateway install and start commands create and launch the Hermes gateway user service that hosts the RipDock Runtime endpoint. Replace <user> with your Linux username, and confirm hermes gateway status reports the gateway is running.

On a virtual server, keep the Hermes dashboard bound to localhost and forward it through SSH from your computer.

nohup hermes dashboard --no-open --host 127.0.0.1 --port 9119 > ~/.hermes/dashboard.log 2>&1 &

In another terminal on your computer, forward the dashboard port.

ssh -L 9119:127.0.0.1:9119 <user>@<your-server>

Then open http://127.0.0.1:9119 in your browser.

What RipDock Needs From Hermes

• A running Hermes Runtime.
• Access to the Hermes dashboard.
• The ability to install or rescan Hermes plugins.

Next: install the RipDock Hermes plugin.