Getting Started

↓ Download .md

Getting Started

Welcome to PodCubo! This guide will help you deploy your first app in minutes.

What is PodCubo?

PodCubo is a modern PaaS (Platform as a Service) for developers. Deploy apps, databases, and static sites without managing servers. If it runs on your localhost, it runs on PodCubo.

Key Concepts

Before you start, here are the main concepts:

  • Stack — A group of services that belong together (e.g., your app + database + cache). Internally, a stack is a pod — all containers share the same network and communicate via localhost. Each stack is isolated from others.
  • App — A service running inside a stack. Can be a web app (from GitHub or Docker image), a database, or a static site.
  • Plan — Defines the resources (CPU, RAM, disk) available for your stack.

Create Your Account

  1. Go to app.podcubo.com and create your account
  2. Verify your email by clicking the link we send you
  3. You're ready to deploy!

Deploy Your First App

From GitHub

  1. Create a new stack and choose a plan
  2. Click New App and select App as the type
  3. Choose Git Repository as the source
  4. Connect your GitHub account and select your repository
  5. Choose the branch (or release) to deploy
  6. Set the port your app listens on
  7. Click Create — PodCubo will clone, build, and deploy automatically

Your app needs a Dockerfile in the repository root. Here's an example for a Node.js app:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]

From a Docker Image

  1. Create a new stack and choose a plan
  2. Click New App and select App as the type
  3. Choose Container Image as the source
  4. Enter the image name (e.g., nginx:alpine)
  5. Set the port and click Create

What's Next?

Next →Deploy from GitHub