Quick Start Guide
Get your application deployed on Oblien in just a few minutes.
Prerequisites
Before you begin, make sure you have:
- A GitHub account
- A repository with your web application
- An Oblien account (sign up at oblien.com)
Step 1: Connect GitHub
- Navigate to your Dashboard
- Click on Library or Deploy
- If not connected, click Connect GitHub
- Authorize Oblien to access your repositories
Oblien only requests access to the repositories you explicitly select. We never access private data without permission.
Step 2: Select Your Repository
- Browse your repositories or use the search bar
- Click on the repository you want to deploy
- Oblien will automatically analyze your project
Step 3: Configure Your Deployment
Oblien automatically detects your framework and sets optimal defaults:
- Framework: Auto-detected (Next.js, React, Vue, etc.)
- Branch: Your default branch (usually
mainormaster) - Build Command: Framework-specific default
- Output Directory: Framework-specific default
- Port: 3000 (configurable)
Common Settings
Project Name
A friendly name for your deployment (defaults to repository name).
Domain
Your app will be available at your-project.oblien.app. Custom domains coming soon!
Root Directory
If your app is in a subdirectory, specify it here (e.g., ./packages/web).
Step 4: Deploy
- Review your configuration
- Click Deploy Now
- Watch your build progress in real-time
You'll see:
- Cloning repository
- Installing dependencies
- Running build command
- Starting your application
- Deployment URL
Your application is typically live within 2-5 minutes!
Step 5: Access Your Application
Once deployment is complete:
- Click the Visit button or copy your deployment URL
- Your app is now live at
https://your-project.oblien.app - Share it with the world!
Next Steps
Now that you've deployed your first app:
- Enable Auto-Deploy: Automatic deployments on every push to your default branch
- View Build History: See all your previous deployments
- Monitor Logs: Check real-time application logs
- Configure Environment Variables: Add secrets and API keys (coming soon)
Need Help?
- Check our Best Practices guide
- Read Troubleshooting for common issues
- Visit our Configuration docs for advanced settings