How to Install WebDecky on a VPS Server: A Complete Step-by-Step Guide

In this useful article, I guide you through installing the WebDecky Website on a VPS Server. If you’re planning to host your own WebDecky website on a Virtual Private Server (VPS), you’ve come to the right place. Installing WebDecky on a VPS gives you complete control over your hosting environment, improved security, better performance, and the flexibility to customize your website according to your needs.

Whether you’re a beginner or an experienced Linux user, this guide will walk you through the entire installation process. By the end of this tutorial, your WebDecky website will be running smoothly on your VPS with a production-ready setup.

Why Host WebDecky on a VPS?

Many website owners start with shared hosting but eventually move to a VPS because of its advantages. Hosting WebDecky on a VPS offers several benefits, including:

• Better performance and faster loading times

• Dedicated server resources

• Full root access

• Improved security

• Easier scalability

• Greater control over software installation and server configuration

A VPS is an ideal choice if you expect your website to grow or want maximum flexibility.

Prerequisites

Before installing WebDecky, make sure you have the following:

• A VPS running Ubuntu 22.04 or Ubuntu 24.04

• Root or sudo access

• A registered domain name (optional but recommended)

• Basic knowledge of Linux commands

• SSH access to your server

• A stable internet connection

You’ll also need your VPS IP address, username, and password or SSH key.

Step 1: Connect to Your VPS

First, connect to your VPS using SSH.

ssh root@your-server-ip

If you’re using a non-root user:

ssh username@your-server-ip

Once connected, update your server packages.

sudo apt update

sudo apt upgrade -y

Keeping your server updated ensures you receive the latest security patches and software improvements.

Step 2: Install Required Packages

Install the essential software required by WebDecky.

sudo apt install curl wget git unzip nginx -y

Depending on your WebDecky version, you may also need Node.js.

Install the latest LTS version:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt install nodejs -y

Verify the installation.

node -v

npm -v

You should see the installed versions displayed.

Step 3: Download the WebDecky Files

Navigate to your preferred installation directory.

cd /var/www

Clone the project.

git clone https://github.com/your-webdecky-repository.git webdecky

Move into the project folder.

cd webdecky

If WebDecky is distributed as a ZIP file instead of Git, upload and extract it using:

unzip webdecky.zip

Step 4: Install Project Dependencies

Install all required Node.js packages.

npm install

Depending on your internet speed and server specifications, this process may take a few minutes.

After installation finishes successfully, you’re ready for the next step.

Step 5: Configure Environment Variables

Many modern web applications use environment variables for configuration.

Create the environment file.

cp .env.example .env

Open the file.

nano .env

Update values such as:

• Application URL

• Database credentials

• API keys

• Secret keys

• SMTP settings

Save the file when finished.

Proper configuration is essential for a successful installation.

Step 6: Build the WebDecky Application

Now build the production application.

npm run build

After the build completes, start the application.

npm start

Alternatively, use PM2 to keep the application running continuously.

Install PM2.

sudo npm install -g pm2

Start WebDecky.

pm2 start npm --name webdecky -- start

Save the PM2 process list.

pm2 save

Enable automatic startup.

pm2 startup

PM2 ensures your website automatically restarts after a reboot or unexpected crash.

Step 7: Configure Nginx

Nginx acts as a reverse proxy for your application.

Create a new configuration file.

sudo nano /etc/nginx/sites-available/webdecky

Example configuration:

server {

listen 80;

server_name yourdomain.com www.yourdomain.com;

location / {

proxy_pass http://localhost:3000;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_set_header Host $host;

proxy_cache_bypass $http_upgrade;

}

Enable the configuration.

sudo ln -s /etc/nginx/sites-available/webdecky /etc/nginx/sites-enabled/

Test Nginx.

sudo nginx -t

Restart the service.

sudo systemctl restart nginx

Your website should now be accessible through your server’s IP address or domain.

Step 8: Secure Your Website with SSL

An SSL certificate protects user data and improves SEO rankings.

Install Certbot.

sudo apt install certbot python3-certbot-nginx -y

Generate an SSL certificate.

sudo certbot --nginx

Follow the prompts to complete the setup.

Certbot will automatically configure HTTPS and redirect HTTP traffic to the secure version of your website.

Step 9: Configure Firewall

Enable the firewall if it isn’t already active.

sudo ufw allow OpenSSH

sudo ufw allow 'Nginx Full'

sudo ufw enable

Check firewall status.

sudo ufw status

Your VPS is now protected while allowing essential web traffic.

Step 10: Test Your Installation

Open your browser and visit:

http://yourdomain.com

https://yourdomain.com

Verify that:

• The homepage loads correctly.

• Images display properly.

• CSS and JavaScript files load.

• Navigation works.

• HTTPS is active.

• No server errors appear.

If everything works, congratulations! Your WebDecky website is successfully running on your VPS.

Common Installation Issues

Website Won’t Load
Check whether your application is running.
pm2 status
Restart if necessary.
pm2 restart webdecky
Nginx Configuration Errors
Test your configuration.
sudo nginx -t

Correct any syntax errors before restarting Nginx.

Watch This Video: Install WebDecky on VPS Server

Permission Problems

Ensure the project files have the correct ownership.
sudo chown -R www-data:www-data /var/www/webdecky

Port Already in Use

Identify the process.
sudo lsof -i :3000

Stop the conflicting service or configure WebDecky to use a different port.

Tips for Better Performance

After installation, consider optimizing your server by:

• Enabling Gzip compression

• Using HTTP/2

• Configuring browser caching

• Using a CDN

• Keeping Ubuntu updated

• Monitoring server resources

• Regularly backing up your website

• Using PM2 monitoring tools

These optimizations help improve website speed and user experience.

Conclusion

Installing WebDecky on a VPS may seem challenging at first, but following a structured approach makes the process straightforward. By preparing your server, installing the required dependencies, configuring Nginx, enabling SSL, and using PM2 for process management, you can create a stable and secure hosting environment for your website.

A VPS provides greater performance, flexibility, and control compared to shared hosting, making it an excellent choice for personal projects, business websites, and growing applications. Remember to keep your server updated, monitor its performance regularly, and perform routine backups to ensure your WebDecky installation remains reliable over time. With your WebDecky website now live, you’re ready to focus on building content, serving your users, and expanding your online presence with confidence.

More

Menu