deploy-vps-local-cx

Deploy OmniRoute builds to a Local VPS via scp and PM2.

44.0k|5.9k|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/diegosouzapw/OmniRoute --skill deploy-vps-local-cx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-vps-local-cx
Source: https://github.com/diegosouzapw/OmniRoute/tree/main/.agents/skills/deploy-vps-local-cx
Command: npx skills add https://github.com/diegosouzapw/OmniRoute --skill deploy-vps-local-cx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the hassle of repeatedly shipping and deploying the latest OmniRoute build to a fixed on-prem Local VPS, ensuring the service is updated and running without manual steps.

Core Features & Use Cases

  • Build and package locally: Produces a clean OmniRoute release artifact by running the CLI build and creating an npm package tarball.
  • Remote installation and runtime updates: Copies the package to the VPS, installs globally while ignoring scripts, rebuilds the native dependency, and restarts the PM2-managed process.
  • Service verification: Confirms the deployment by checking the Local VPS HTTP endpoint returns a response code.

What problem does it solve?

Deploys the OmniRoute gateway reliably to a known host (192.168.0.15) with PM2 to keep your AI routing endpoint current.

Quick Start

Use deploy-vps-local-cx to package OmniRoute, upload it to the Local VPS, restart the PM2 process, and verify the endpoint responds on port 20128.

Frequently Asked Questions about deploy-vps-local-cx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an OmniRoute build to a VPS using PM2?

Deploying OmniRoute to a VPS via PM2 involves building the package locally, creating an npm pack tarball, secure copying it to the server, installing globally with --ignore-scripts, rebuilding better-sqlite3, and restarting PM2 to update the endpoint.

What is the process for updating an on-prem OmniRoute endpoint reproducibly?

Updating an on-prem OmniRoute endpoint reproducibly requires packaging a clean local build into an npm tarball, uploading it via scp to the VPS, and running a global npm install with --ignore-scripts before restarting the PM2 process.

How does server verification work after an SSH VPS deployment?

Server verification after an SSH VPS deployment confirms the service is running by checking the HTTP endpoint response code, validating that the OmniRoute gateway is live and accessible at the specified local IP address and port.

Do I need to rebuild better-sqlite3 when deploying OmniRoute to a Local VPS?

Yes, you need to rebuild better-sqlite3 when deploying OmniRoute to a Local VPS because the global installation uses the --ignore-scripts flag, which skips native dependency compilation, requiring a manual rebuild step before restarting PM2.

Can I use npm pack to create a deployment artifact for SSH transfer?

Yes, you can use npm pack to create a deployment artifact for SSH transfer by running a local CLI build to produce a clean OmniRoute release tarball, which is then securely copied to the remote VPS /tmp directory for installation.

What are the limitations of deploying to a fixed Local VPS address?

Deploying to a fixed Local VPS address limits the process to a specific on-prem host at 192.168.0.15, meaning the deployment workflow is not directly portable to dynamic hosts or cloud environments without modifying the target IP and verification endpoint.