Skip to main content

Deploy Your First App

This guide walks you through deploying your first application on Kuploy. By the end, you'll have a running application accessible via a Kuploy-provided domain.

Prerequisites​

  • A Kuploy account
  • A Git repository with your application code (GitHub, GitLab, or Bitbucket)

Create a Project​

Projects help you organize related applications, databases, and resources.

  1. Navigate to your Kuploy dashboard
  2. Click New Project
  3. Enter a project name (e.g., "my-web-app")
  4. Select your preferred region
  5. Click Create Project
tip

Choose a region closest to your users for the best performance.

Add an Application​

  1. Inside your project, click Add Resource → Application
  2. Enter a name for your application
  3. Click Create Application

Connect Your Git Repository​

  1. In your application settings, go to the Source tab
  2. Click Connect Repository
  3. Choose your Git provider (GitHub, GitLab, or Bitbucket)
  4. Authorize Kuploy to access your repositories
  5. Select the repository containing your application
  6. Choose the branch to deploy (usually main or master)

Choose a Build Method​

Kuploy supports three build methods:

Nixpacks automatically detects your application's language and framework, then builds an optimized container image.

Supported languages include:

  • Node.js / JavaScript / TypeScript
  • Python
  • Go
  • Rust
  • Ruby
  • PHP
  • Java
  • .NET
  • And many more
# Nixpacks automatically detects your app type
# No configuration needed for most applications
info

Nixpacks is the default and recommended option for most applications. It requires zero configuration for standard projects.

Dockerfile​

If you have specific requirements, you can use your own Dockerfile:

  1. Select Dockerfile as the build method
  2. Specify the Dockerfile path (default: Dockerfile)
  3. Optionally set the build context
# Example Dockerfile for a Node.js app
FROM node:20-alpine

WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .

EXPOSE 3000
CMD ["npm", "start"]

Buildpacks​

Cloud Native Buildpacks provide another automated build option:

  1. Select Buildpacks as the build method
  2. Choose a buildpack provider (Heroku, Paketo, or Google)
  3. Configure any required build environment variables

Configure Your Application​

Port Configuration​

Kuploy automatically detects the port your application listens on. If needed, you can manually set it:

  1. Go to Settings → Network
  2. Set the Port to match your application (e.g., 3000, 8080)

Resource Allocation​

Configure CPU and memory limits:

PlanCPUMemory
Starter0.5 vCPU512 MB
Standard1 vCPU1 GB
Pro2 vCPU4 GB

Deploy Your Application​

  1. Click the Deploy button
  2. Watch the build logs in real-time
  3. Once complete, your app is live!

Access Your Application​

After deployment, your application is available at:

https://[app-name]-[random-id].kuploy.app

You can find the full URL in the application overview page.

tip

Add a custom domain to use your own URL like app.yourdomain.com.

Automatic Deployments​

Enable automatic deployments to redeploy whenever you push to your branch:

  1. Go to Settings → Source
  2. Toggle Auto Deploy on
  3. Optionally add branch filters or path filters

Now every push to your configured branch will trigger a new deployment automatically.

Next Steps​