← All Guides
Onboarding5 min read

Getting Started

New to Oxaploy? Start here. Learn how to create your account, connect your first server, and deploy your first application in minutes.

1.Create Your Oxaploy Account

Sign up for Oxaploy and set up your first team.

  1. Visit https://oxaploy.com and click Get Started
  2. Enter your email and create a secure password
  3. Verify your email address
  4. Create your first team (personal or organization)
  5. You'll land on the dashboard — ready to connect your first server

2.Connect Your VPS via SSH

Add your server to Oxaploy using SSH key authentication (recommended) or password.

  1. In the dashboard, click New Server
  2. Enter a name for your server (e.g., production-web)
  3. Enter your server's IP address or hostname
  4. Choose authentication method: SSH Key (recommended) or Password
  5. If using SSH Key: paste your public key (~/.ssh/id_ed25519.pub)
  6. Click Add Server — Oxaploy will test the connection
# Generate SSH key if you don't have one
ssh-keygen -t ed25519 -C "your-email@example.com"

# View your public key
cat ~/.ssh/id_ed25519.pub

3.Deploy Your First Application

Deploy a sample application to understand the Oxaploy deployment pipeline.

  1. From the dashboard, click New App
  2. Select your server
  3. Enter app name (e.g., hello-world)
  4. Enter your Git repository URL (GitHub, GitLab, or Bitbucket)
  5. Choose branch (default: main)
  6. Oxaploy auto-detects framework — verify or override
  7. Set build command (e.g., npm run build) and start command (e.g., npm start)
  8. Add environment variables if needed
  9. Click Deploy — watch the build logs in real-time

4.Verify Your Deployment

Confirm your application is live and accessible.

  1. Wait for build to complete (green checkmark)
  2. Click the app URL — your app should load
  3. Check Metrics tab for CPU, RAM, and request metrics
  4. Configure custom domain in Domains tab
  5. Enable SSL — automatic Let's Encrypt certificates