First Deployment - Replov Docs
Skip to main content

Your First Deployment

This comprehensive guide will walk you through deploying your first web service on Replov, from connecting GitHub to seeing your app live.

Time Required
This tutorial takes approximately 5 minutes to complete.

Prerequisites

  • A GitHub account
  • A repository with your application code
  • A Replov account (sign up is free)
Don't have an app ready? We'll provide a sample Node.js application you can use.

Step 1: Connect GitHub

Authorize Replov

  1. 1. Click "Connect GitHub" in the navbar
  2. 2. You'll be redirected to GitHub's authorization page
  3. 3. Review the permissions Replov requests
  4. 4. Click "Authorize Replov"
  5. 5. Select which repositories Replov can access
Replov uses the GitHub access you authorize to list and clone selected repositories. Turn on Auto Deploy on a service to deploy every push to its branch. You can revoke access at any time.

Step 2: Create a Project

Group Your Services

  1. 1. Navigate to your dashboard
  2. 2. Click "New Project" button
  3. 3. Enter project details:
    • • Name: my-first-app
    • • Repository: Select from dropdown
    • • Branch: main (or master)
  4. 4. Click "Create Project"

Step 3: Create Your First Service

Configure & Deploy

  1. 1. Inside your project, click "New Service"
  2. 2. Select service type: Web Service
  3. 3. Replov auto-detects your runtime (Node.js, Python, etc.)
  4. 4. Choose a plan:
    • • Nano Compute: ₹199 per service / 30 days (0.5 CPU, 512MB RAM); first two Nano Static Sites are free
    • • Micro: ₹599/month (1 CPU, 1GB RAM) ← Recommended
  5. 5. Select billing: Hourly (for testing)
  6. 6. Click "Deploy Now"
Compute Trial
With an active Replov plan, each new non-Nano service gets the existing 3-day compute trial before service-level billing begins.

Sample Application

If you don't have an app ready, create these two files in a new GitHub repository:

index.jsjavascript
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.json({
message: 'Hello from Replov!',
timestamp: new Date().toISOString(),
environment: process.env.NODE_ENV || 'development'
});
});
app.get('/health', (req, res) => {
res.json({ status: 'healthy' });
});
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
console.log(`🚀 Server running on port ${PORT}`);
});
package.jsonjson
{
"name": "my-first-Replov-app",
"version": "1.0.0",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"express": "^4.18.2"
},
"engines": {
"node": ">=18.0.0"
}
}

What Happens During Deployment?

1
Code Pull:

Replov clones your repository from GitHub

2
Framework Detection:

Replov detects Node.js from package.json and generates a Dockerfile for it

3
Build:

Dependencies are installed (npm install)

4
Containerize:

Your app is packaged into a Docker container

5
Deploy:

Container is deployed to our infrastructure

6
SSL Provisioning:

HTTPS certificate is automatically created

✓
Live!

Your service is accessible via public HTTPS URL

Typical deployment time is 2-3 minutes. You can watch the build logs in real-time from your dashboard.

Accessing Your Application

Once deployment is complete, you'll see:

Your service URL:

https://my-first-app-a1b2.replov.com

Click the URL to open your application in a new tab. You should see your JSON response!

Next Steps

🎉 Congratulations!

You've successfully deployed your first service on Replov. Here's what to explore next: