Skip to content

RENDER-DEPLOYMENT.md

Latest commit

 

History

History
163 lines (117 loc) · 3.83 KB

RENDER-DEPLOYMENT.md

File metadata and controls

163 lines (117 loc) · 3.83 KB
Raw

OpenCodeHub — Render Deployment Guide

Deploy to Render (Singapore) with free PostgreSQL + Upstash Redis. $0/month.

What You Get

  • OpenCodeHub running in Asia (Singapore)
  • Free PostgreSQL database
  • Free Redis via Upstash
  • 1GB persistent storage for git repos
  • HTTPS included
  • Admin account

Step 1: Create Upstash Redis (2 min)

  1. Go to https://upstash.com → Sign up (free)
  2. Click Create Database
  3. Settings:
    • Name: opencodehub
    • Region: Asia Pacific (Singapore)
    • Plan: Pay as you go (free tier: 10K commands/day)
  4. Click Create
  5. Copy the Redis URL (looks like rediss://...@...)
  6. Keep this tab open — you'll need it in Step 3

Step 2: Deploy to Render (5 min)

  1. Go to https://render.com → Sign up (free)
  2. Click New → Blueprint
  3. Connect your GitHub account
  4. Select your OpenCodeHub repository
  5. Render detects render.yaml and shows:
    • opencodehub-db (PostgreSQL — Singapore)
    • opencodehub (Web Service — Singapore)
  6. Click Apply
  7. Wait for deployment (~3-5 min first time)

Step 3: Set Redis URL (1 min)

  1. Go to your Web Service → Environment tab
  2. Find REDIS_URL (shows "Not set")
  3. Click the pencil icon → Paste your Upstash Redis URL
  4. Click Save

Step 4: Set Site URL (1 min)

  1. In the same Environment tab
  2. Find SITE_URL (shows "Not set")
  3. Click the pencil icon → Enter your Render URL: 
    https://opencodehub.onrender.com
    (Replace with your actual URL from the service overview)
  4. Click Save

Step 5: Manual Deploy

  1. Go to your Web Service → Manual Deploy
  2. Click Deploy latest commit
  3. Wait for build to complete (~2-3 min)
  4. Click the URL at the top to open your instance

Step 6: Create Admin Account

You'll see the Setup Wizard. Fill in:

Field Value
Username admin (or your choice)
Email Your email
Password Strong password

Click Create Account — you're now logged in as admin!

Step 7: Test It

# Create a repo via web UI, then clone:
git clone https://opencodehub.onrender.com/your-username/my-repo.git

# Push code:
cd my-repo
echo "# Hello" > README.md
git add . && git commit -m "Initial"
git push origin main

Done! Summary

Component Service Region Cost
App Render Free Singapore $0
PostgreSQL Render Free Singapore $0
Redis Upstash Free Singapore $0
Storage Render Disk 1GB Singapore $0
Total $0/month

Keep Alive (Optional)

Render free tier spins down after 15min inactivity. To prevent:

  1. Go to https://uptimerobot.com → Sign up (free)
  2. Add Monitor → Type: HTTP(s)
  3. URL: https://opencodehub.onrender.com/api/health
  4. Monitoring interval: 5 minutes
  5. Save — your app stays awake

Upgrade Path (When You Grow)

Need Upgrade Cost
Always-on (no spin-down) Render Starter $7/mo
More storage (10GB+) Render Disk upgrade $1-7/mo
More Redis commands Upstash Pay-as-you-go ~$0.20/10K
PostgreSQL expiry Render Starter DB $7/mo

Troubleshooting

App won't start?

  • Check Logs tab in Render
  • Verify REDIS_URL is set correctly
  • Ensure SITE_URL matches your Render URL

Redis connection failed?

  • Verify Redis URL from Upstash (starts with rediss://)
  • Check Upstash dashboard shows "Active"
  • Ensure region is Singapore

Git clone fails?

  • Use HTTPS: git clone https://your-url.onrender.com/user/repo.git
  • SSH not available on Render free tier (use HTTPS)

Slow first request?

  • Normal for free tier (cold start ~30s)
  • Add UptimeRobot ping to keep it warm

OpenCodeHub — Deployed on Render, Asia Region, $0/month.