Back to articles
AI & Cloud

Running Kubernetes on VPS: K3s Deployment Guide for Developers and Startups

A detailed guide on deploying K3s on VPS to build a lightweight, fast, and cost-effective Kubernetes environment for developers and startups. Includes configuration, installation,...

DPTCloud Engineering4 min read
Running Kubernetes on VPS: K3s Deployment Guide for Developers and Startups

Running Kubernetes on VPS: K3s Deployment Guide for Developers and Startups

In the context of modern application development, deploying a Kubernetes (K8s) environment on a VPS is an ideal solution for developers and startups seeking a flexible, efficient, and cost-effective container management system. However, traditional Kubernetes often requires high resources, making it unsuitable for VPS environments with limited configurations. K3s – a lightweight distribution of Kubernetes – is the perfect choice for such scenarios.

Why Choose K3s on VPS?

K3s is a Kubernetes distribution optimized to run on edge devices, VPS, and resource-constrained environments. Compared to standard Kubernetes, K3s offers:

  • Lighter components, using less than 50MB RAM when running.
  • No separate database – uses SQLite instead of etcd.
  • Simplified configuration and deployment.
  • Well-suited for self-hosted environments, local developer setups, and startups.

This solution is ideal for building microservices systems, CI/CD pipelines, or deploying lightweight AI/ML applications on VPS.

Requirements and Preparation

To deploy K3s on a VPS, you need:

  • A VPS server (minimum 2GB RAM, 1 CPU, 20GB SSD).
  • Linux operating system (Ubuntu 20.04/22.04 or Debian 11/12).
  • Stable internet connection.
  • Sudo or root access on the VPS.

Deploying K3s on VPS

Installation requires only one command:

# Install K3s
curl -sfL https://get.k3s.io | sh -

# Check status
sudo systemctl status k3s

After installation, K3s automatically starts and creates a single-node cluster (master and worker on the same node).

Verifying K3s Operation

To confirm that K3s is running correctly, perform the following steps:

# Get cluster info
kubectl cluster-info

# Check nodes
kubectl get nodes

# Check default pods
kubectl get pods -n kube-system

The output should show the node and system pods like `coredns`, `metrics-server`, etc. If all are in `Running` state, K3s is successfully operational.

Deploying a Sample Application

Deploy a simple application to test container management:

# demo-app.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-app
  template:
    metadata:
      labels:
        app: demo-app
    spec:
      containers:
      - name: demo-app
        image: nginx:alpine
        ports:
        - containerPort: 80

Deploy the application:

kubectl apply -f demo-app.yaml
kubectl get pods

The application will run on the K3s cluster and can be accessed via a service if needed.

Scaling Solutions for Startups

For startups, you can enhance K3s with:

  • FluxCD: For automated CI/CD deployment of applications.
  • ArgoCD: To manage environment states using GitOps.
  • NGINX Ingress: To route traffic to services.

Adding these components to K3s enables a self-managed, flexible, and scalable system.

AI and API Gateway Solutions on VPS

For AI or API gateway projects, use high-RAM VPS (such as High-RAM Cloud VPS for Self-Hosted LLMs & API Gateways) to run K3s with:

  • Self-hosted LLMs like Llama 3 or Mistral.
  • API gateways like Kong or Traefik.
  • AI video subtitle farms using Whisper (see Build an AI Video Subtitle Farm).

Troubleshooting

  • Cannot connect to K3s: Check that the `k3s` service is running with `sudo systemctl status k3s`.
  • Pods not running: Check logs using `kubectl logs -n kube-system`.
  • Access denied: Ensure `kubectl` is correctly configured with the `~/.kube/config` file.

References

Running Kubernetes on a VPS with K3s is an effective way to build modern, cost-efficient, and scalable systems – particularly suitable for developers and startups with limited budgets.

DPTCloud Tier III Infrastructure

High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478