Quick Start
Three steps. Under 5 minutes. Your app is live.
Step 1: Create Your App
- Sign up at omaship.com
- Click "Create New App"
- Enter your app name and domain
Omaship creates your GitHub repository, configures CI/CD, sets up secrets, and executes the initial server run. This takes about 60 seconds.
Step 2: Configure DNS
Add these DNS records at your domain registrar:
A @ → [Your server IP]
A www → [Your server IP]
CNAME *.preview → yourdomain.comThe server IP is shown in your Omaship dashboard. The wildcard CNAME enables PR preview deployments.
Step 3: You're Live
Once DNS propagates (usually 5-30 minutes), your app is live at your domain with SSL, CI/CD, preview deployments, and automated daily backups.
That's it. No server setup. No secret configuration. No deployment scripts. Just DNS.
Requirements
For the managed hosting flow (most users), you need:
- GitHub account — Install the Omaship GitHub App to authorize repo creation
- A domain you control — With access to DNS settings
If bringing your own VPS:
- Ubuntu 22.04+ with 2GB+ RAM and SSH access
- Public IP address for DNS configuration
Recommended: Hetzner CX22 (2 vCPU, 4GB RAM) at 4.85 EUR/month or CAX11 (ARM, 4GB RAM) at 3.79 EUR/month.
Local Development
To develop locally on your shipped app:
git clone [email protected]:your-org/your-app.git
cd your-app
bundle install
rails db:setup
bin/devRequires Ruby 3.3+, SQLite 3.35+, and Node.js 20+. Use mise, rbenv, or asdf for Ruby version management.
What's Next?
- Build your first feature — Step-by-step tutorial with Claude Code
- Working with AI tools — Tips for effective AI-assisted development
- How Omaship works — Understand the engine architecture