How to Set Up and Operate Hermes Agent
Operating a Self-managed VPS or VDS in a headless terminal environment requires a precise execution order. Now that Hermes Agent is successfully installed on your server machine, you must configure, bind, and operate your agent instance cleanly. Executing components or tools out of sequence can result in profile mismatch configurations or background system daemon failures. This operational guide details how to perform initial runtime checks, initialize environment profile syncs, manipulate workspace datasets, manage messaging gateways, and coordinate process persistence loops.
1. Verifying Installation Health and Running System Audits
Before modifying any configurations, ensure your pre-existing Hermes Agent binary is healthy and correctly mapped within your environment variables. Running an immediate health audit prevents setup bottlenecks later.
Step 1: Check the Software Version Boundary
From your server command prompt, call the version flag:
root@vps-server:~# hermes --version
Example Output:
hermes-agent version 0.19.0 (build_meta: stable-linux-amd64)
Step 2: Run the Automated Doctor Diagnostics Suite
Execute the native verification engine to scan active core configuration structures, binary paths, tool access permissions, and folder boundaries:
root@vps-server:~# hermes doctor
Example Output:
[Doctor] Initiating environment diagnostics...
[✓] Checking system binary path mappings: Valid (/usr/local/bin/hermes)
[✓] Validating base environment variables: Configured
[✓] Auditing workspace folder access permissions: Clear
[✓] Scanning network configuration paths: Outbound port 443 accessible
[Status] System diagnostics complete. Status: 100% Operational.
2. Token Handshake and Profile Synchronization
Even though the core binaries are present on your server instance, Hermes remains an unconfigured blank slate until it is bound to your identity. To switch models dynamically and use integrated tool APIs without managing raw API keys, you must bind your terminal environment with your central Nous Portal profile.
Step 1: Execute the Portal Onboarding Hook
From your server prompt, run the setup sync script:
root@vps-server:~# hermes setup --portal
Example Output:
[Setup] Initializing Nous Portal link routine...
[Setup] Local OAuth engine listening on loopback interface: http://127.0.0.1:8642
[Action Required] Copy and open the following secure validation link in your browser:
➡️ https://portal.nous.research/onboard/agent-bind?token=a8f92c304d9e11efb83
Step 2: Complete OAuth Authentication Link
The terminal will output a unique authentication token sequence. Copy the onboarding URL, paste it into your desktop browser, authorize your Nous Portal profile connection, and wait for your headless server terminal to clear:
Example Output:
[System] Connection authorized.
[System] Successfully pulled profile configurations down from Nous Portal.
[System] Workspace environment mapping initialized cleanly at ~/.hermes/ config environments written to ~/.hermes/.env and ~/.hermes/config.yaml