TutorialNode.jsDeployment

How to Deploy a Node.js App to Your VPS with BYOS Panel

March 28, 2026BYOS Team8 min read

Introduction

Deploying a Node.js application to a VPS gives you complete control over your infrastructure. Unlike managed platforms that abstract away the server, running on your own VPS means you choose the hardware, the operating system, the network configuration, and the scaling strategy. You are not limited by arbitrary platform constraints, and you are not paying a premium for convenience that disappears the moment you need something non-standard.

The trade-off has always been complexity. Configuring Nginx reverse proxies, managing process managers, setting up SSL certificates, and wiring up CI/CD pipelines from scratch can take hours or even days. BYOS Panel eliminates that friction entirely. You get the control of a VPS with a deployment experience that rivals the best PaaS platforms, and the entire process from server connection to live deployment takes under ten minutes.

Prerequisites

Before you start, make sure you have the following ready:

  • A VPS running Ubuntu 22.04 or later (DigitalOcean, Hetzner, AWS EC2, Linode, or any provider)
  • A BYOS Panel account (start a free trial at byospanel.com)
  • A Node.js application with a valid package.json file
  • Your application code hosted in a GitHub or GitLab repository
  • Root or sudo access to your VPS via SSH

Step 1: Connect Your Server

Log into your BYOS Panel dashboard and navigate to the Servers section. Click the "Add Server" button and enter your server's public IP address along with a friendly name to identify it in the dashboard. BYOS Panel will generate a unique installation command tailored to your account.

SSH into your VPS and paste the installation command. It looks something like this:

curl -sSL https://byospanel.com/install | bash -s -- --token YOUR_UNIQUE_TOKEN

The lightweight Go agent installs in approximately 30 seconds. It registers itself with the BYOS Panel API, establishes an encrypted outbound connection, and begins reporting system metrics. Within moments your server status will change to ONLINE in the dashboard. No inbound ports need to be opened for the agent to function because all communication is initiated outbound from your server.

Step 2: Create a Website

With your server connected, navigate to the Websites section and click "Create Website." Select the Node.js runtime from the dropdown menu. Enter your domain name (for example,api.yourdomain.com) and configure the port that your Node.js application listens on. BYOS Panel automatically configures an Nginx reverse proxy that forwards incoming HTTP and HTTPS traffic to your application port.

You can also set the Node.js version your application requires. BYOS Panel supports Node.js 16, 18, 20, and 22 LTS releases. The selected version is installed automatically on your server using nvm, so you do not need to manage Node installations manually.

Step 3: Set Up Git Deployment

In the website settings, navigate to the Git tab and connect your GitHub or GitLab repository. Authorize BYOS Panel to access your repository and select the branch you want to deploy from, typically main or production.

Configure a webhook so that every push to your deployment branch triggers an automatic build. Set your build command to handle dependency installation and compilation:

npm install && npm run build

Set the start command that BYOS Panel will use to launch your application after a successful build:

npm start

BYOS Panel manages your application process using PM2 under the hood, ensuring automatic restarts on crashes and zero-downtime deployments when new code is pushed.

Step 4: Configure Environment Variables

Most Node.js applications require environment variables for database connections, API keys, and runtime configuration. Navigate to the Environment tab in your website settings and add your variables through the dashboard interface. Common variables include:

  • DATABASE_URL — Your PostgreSQL or MySQL connection string
  • API_KEY — Third-party API credentials
  • NODE_ENV=production — Ensures your app runs in production mode
  • PORT — The port your app listens on (should match the website config)
  • JWT_SECRET — Secret key for authentication tokens

Environment variables are encrypted at rest and injected into your application process at runtime. They are never exposed in build logs or the Git repository.

Step 5: Enable SSL

Securing your application with HTTPS is essential for production deployments. In the SSL tab of your website settings, click "Provision SSL Certificate." BYOS Panel uses Let's Encrypt to issue a free TLS certificate for your domain. The entire provisioning process takes about 30 seconds and requires no manual DNS configuration beyond having your domain pointed to your server's IP address.

Certificates are automatically renewed before expiration, so you never need to worry about expired certificates causing downtime or security warnings for your users.

Step 6: Monitor Your App

Once deployed, your application is immediately visible in the monitoring dashboard. BYOS Panel collects CPU usage, memory consumption, disk utilization, and network throughput from your server every five minutes. The dashboard displays 24-hour history graphs so you can spot trends, identify traffic spikes, and catch resource bottlenecks before they affect your users.

Deployment logs are available in the Deployments tab, showing the full output of each build including npm install logs, compilation output, and any errors that occurred during the build process.

Tips for Production

  • Process management: BYOS Panel uses PM2 under the hood for Node.js applications, providing automatic restarts, cluster mode for multi-core utilization, and graceful shutdowns during deployments.
  • Health checks: Configure a health check endpoint in your application (such as /health) that returns a 200 status code. This helps monitoring tools verify that your application is responding correctly.
  • Backups: Enable automatic backups in your BYOS Panel plan settings to ensure your application data and database are backed up on a regular schedule.
  • Firewall: Use the BYOS Panel firewall manager to restrict access to your server. Allow only ports 80, 443, and your SSH port from trusted IP addresses.

Conclusion

Deploying a Node.js application to your own VPS does not have to be complicated. With BYOS Panel, you get the control and cost savings of running your own server combined with the simplicity of a modern deployment platform. From Git push to live application in minutes, with SSL, monitoring, and process management included out of the box.

Ready to deploy your first application? Start your free trial and have your Node.js app running on your own server in under ten minutes.

← Back to Blog