← All Guides
Deployment10 min read

Deploy Your First App

Deploy a sample application to understand the Oxaploy deployment pipeline from repository to live URL.

1.Prepare Your Repository

Ensure your Git repository is ready for Oxaploy deployment.

  1. Push your code to GitHub, GitLab, or Bitbucket
  2. Ensure package.json (Node.js) or equivalent exists
  3. Verify build and start commands work locally
  4. Commit and push to your target branch (default: main)

2.Configure Build and Start Commands

Tell Oxaploy how to build and run your application.

  1. In New App form, select your server
  2. Enter repository URL and branch
  3. Oxaploy auto-detects framework — verify detection
  4. Set build command (e.g., npm run build, go build, pip install -r requirements.txt)
  5. Set start command (e.g., npm start, ./myapp, gunicorn app:app)
  6. Set port if non-standard (default: 3000 for Node, 8000 for Python/Go)

3.Set Environment Variables

Configure secrets and config for your production environment.

  1. In app settings, go to Environment Variables
  2. Add each variable: KEY=VALUE
  3. Mark sensitive values as Secret (encrypted at rest)
  4. Common variables: DATABASE_URL, JWT_SECRET, API_KEYS
  5. Reference in code: process.env.KEY (Node) or os.getenv('KEY') (Python)

4.Deploy and Verify

Launch your deployment and confirm everything works.

  1. Click Deploy — watch real-time build logs
  2. Build phase: dependencies install, code compiles
  3. Deploy phase: container starts, health checks run
  4. Green checkmark = deployment successful
  5. Click app URL to verify live application
  6. Check Metrics for CPU, RAM, requests
  7. Add custom domain and enable SSL in Domains tab