micsapp Replit Deploy Integration
Overview
Deploy applications on Replit's hosting platform. Covers Replit Deployments (Static, Autoscale, Reserved VM), configuring .replit files, managing secrets, and setting up custom domains.
Prerequisites
- Replit account with Deployments enabled (Core or Teams plan)
- Application code in a Repl
- Custom domain (optional) with DNS access
- Replit CLI or web dashboard access
Instructions
Step 1: Configure .replit File
# .replit
run = "npm start"
entrypoint = "index.js"
[deployment]
run = ["sh", "-c", "npm start"]
deploymentTarget = "autoscale"
[nix]
channel = "stable-24_05"
[env]
NODE_ENV = "production"
PORT = "3000" # 3000: 3 seconds in ms
Step 2: Set Secrets
1. Open your Repl in Replit
2. Click the lock icon (Secrets) in the sidebar
3. Add each secret:
- Key: API_KEY, Value: your-api-key
- Key: DATABASE_URL, Value: your-db-url
# Or via Replit CLI
replit secrets set API_KEY "your-api-key"
replit secrets set DATABASE_URL "your-db-url"
Step 3: Deploy
1. Click "Deploy" button in the Replit editor
2. Choose deployment type:
- **Static**: For frontend-only apps (free)
- **Autoscale**: Scales to zero, pay per request
- **Reserved VM**: Always-on, fixed monthly cost
3. Configure machine size (0.25 - 8 vCPU)
4. Click "Deploy"
Step 4: Custom Domain Setup
1. Go to Deployment settings > Custom Domain
2. Enter your domain: app.example.com
3. Add DNS records:
- CNAME: app -> your-repl.replit.app
4. Wait for SSL certificate provisioning
Step 5: Health Check Endpoint
// health.ts
export async function GET() {
return Response.json({
status: "healthy",
environment: process.env.REPL_SLUG,
region: process.env.REPLIT_DEPLOYMENT_REGION,
timestamp: new Date().toISOString(),
});
}
Error Handling
| Issue | Cause | Solution |
|---|---|---|
| Deploy fails | Build error | Check console logs in Replit |
| Port mismatch | Wrong PORT | Use process.env.PORT or 3000 |
| Cold start slow | Autoscale spin-up | Use Reserved VM for latency-sensitive apps |
| Secret not found | Not set in Secrets | Add secret via Replit sidebar |
Examples
Quick Deploy via CLI
set -euo pipefail
# Install Replit CLI
npm install -g replit
# Deploy current repl
replit deploy --type autoscale
Resources
Next Steps
For multi-environment setup, see replit-multi-env-setup.
Output
- Configuration files or code changes applied to the project
- Validation report confirming correct implementation
- Summary of changes made and their rationale