Back to articles
AI & Cloud

Complete Guide to Self-Deploying Supabase Local on a 1 VCPU VPS: The Perfect Firebase Alternative for MVP Projects

A detailed guide on self-hosting Supabase on a 1 VCPU VPS, offering a complete Firebase alternative for MVP projects with low cost and full control. Covers setup, configuration,...

DPTCloud Engineering4 min read
Complete Guide to Self-Deploying Supabase Local on a 1 VCPU VPS: The Perfect Firebase Alternative for MVP Projects

In an era where cloud platforms like Firebase are increasingly expensive and vendor-dependent, self-hosting solutions like Supabase Local on a 1 VCPU VPS have become the ideal choice for MVP (Minimum Viable Product) projects. This guide walks you through the complete process of deploying Supabase locally on a VPS with minimal resources, giving you full control over your data, APIs, and infrastructure while significantly reducing costs compared to Firebase.

Introduction to Supabase and Why Replace Firebase

Supabase is an open-source backend platform designed to replicate Firebase's core features—Authentication, PostgreSQL Database, Storage, and Realtime—while giving you the freedom to host it yourself. Unlike Firebase, which locks you into a proprietary cloud environment, Supabase allows you to self-host the entire stack on your own infrastructure, ensuring data sovereignty and customization.

For MVP development, deploying Supabase Local on a 1 VCPU VPS is ideal because:

  • Low cost: Only requires a budget VPS (e.g., 1 VCPU, 2GB RAM or higher)
  • Full control: You own the source code and database
  • Scalability: Easily expand as your project grows
  • No resource limits: No caps on API calls, storage, or users

Prerequisites and Environment Setup

To deploy Supabase Local on your VPS, you’ll need:

  • A VPS with at least 1 VCPU and 2GB RAM (4GB recommended)
  • Ubuntu 22.04 or 20.04 as the operating system
  • SSH access or terminal access
  • Docker and Docker Compose installed

Run the following commands to install Docker and Docker Compose if they’re not already present:

# Install Docker
sudo apt update
sudo apt install -y docker.io docker-compose
# Add user to docker group
sudo usermod -aG docker $USER
# Start and enable Docker
sudo systemctl enable docker
sudo systemctl start docker

Deploying Supabase Local with Docker Compose

Supabase provides a docker-compose.yml file to deploy the full stack. You can use the official version or customize it for your needs.

Run the commands below to create a directory and download the configuration file:

mkdir supabase-local && cd supabase-local
curl -o docker-compose.yml https://raw.githubusercontent.com/supabase/supabase/main/docker-compose.yml

Modify the docker-compose.yml file to set environment variables such as:

  • SUPABASE_URL: Access URL (e.g., http://localhost:8080)
  • SUPABASE_ANON_KEY: Anonymous key (auto-generated)
  • SUPABASE_SERVICE_ROLE_KEY: Service role key (auto-generated)
  • POSTGRES_PASSWORD: PostgreSQL database password

Start the Supabase stack with:

docker-compose up -d

Once running, access the following services:

  • Dashboard: http://:8080
  • API: http://:8080/rest/v1
  • Authentication: http://:8080/auth

Authentication and Performance Optimization

To ensure stable performance on a 1 VCPU VPS, apply the following optimizations:

  • Limit Docker resources: Use docker-compose.yml to restrict CPU and RAM usage
  • Integrate Cloudflare: Use a proxy for security and faster access
  • Set up regular backups: Use cron jobs to back up PostgreSQL data
  • Enable HTTPS: Use Let's Encrypt with Nginx or Traefik

Test the authentication endpoint using this CLI command:

curl -X POST "http://<your-vps-ip>:8080/auth/v1/token?grant_type=password" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"password"}'

Supabase as a Firebase Alternative for MVP Projects

Supabase Local on a 1 VCPU VPS is a perfect Firebase replacement for MVPs because:

  • No resource limits
  • No usage-based pricing
  • Full API and database customization
  • Open-source control

Comparison between Supabase Local and Firebase:

Feature Supabase Local Firebase
Cost Low (only VPS cost) High (usage-based pricing)
Control 100% control Limited control
Customization Full source code access Limited customization
Optimization Custom-tailored Fixed architecture

Troubleshooting and Verification

If you encounter issues:

  • Dashboard not accessible: Check if port 8080 is open and Docker is running
  • PostgreSQL connection failure: Verify POSTGRES_PASSWORD and docker-compose.yml settings
  • Low performance: Increase VPS RAM or limit Docker resource usage

Check the status of services with:

docker-compose ps
docker-compose logs -f supabase-db

References

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