Kubeletto
Deploy Guide · TypeScript / JavaScript

Deploy a Nuxt.js App

Ship Nuxt 3 SSR apps without Vercel or Netlify lock-in.

Start Deploying Free Read the Docs

Overview

Nuxt 3 is the Vue.js full-stack framework with SSR, file-based routing, and a built-in Nitro server. Deploying Nuxt on Kubeletto gives you the full SSR experience — server-side rendering, API routes, server middleware — in a portable container that you own.

Prerequisites

  • A Nuxt 3 project
  • nuxt.config.ts configured for Node.js server (default)
  • A Kubeletto account

Step-by-Step Guide

Deploying Nuxt 3 to Kubeletto is done by configuring a Dockerfile, connecting your GitHub repository, and setting environment variables. Follow this step-by-step checklist to deploy your code:

  1. 1

    Build for Node.js server output

    Nuxt 3 defaults to Node.js server output, which is what Kubeletto expects.

    typescript 
    # nuxt.config.ts
export default defineNuxtConfig({
  nitro: {
    preset: 'node-server'
  }
})
  2. 2

    Create a Dockerfile

    Build the Nuxt app and serve with the Nitro node server.

    dockerfile 
    FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/.output ./
EXPOSE 3000
CMD ["node", "server/index.mjs"]
  3. 3

    Deploy

    Connect your GitHub repo and push.

    bash 
    kubeletto deploy --source github --repo your-org/nuxt-app --branch main

Sample Environment Variables

To configure your Nuxt 3 application, set these key-value pairs in the environment variables tab of the Kubeletto console or CLI. Ensure production secrets are flagged as write-only:

.env 
NUXT_PUBLIC_API_URL=https://your-api.kubeletto.app
NUXT_SECRET=your-secret
DATABASE_URL=postgres://...
NODE_ENV=production

Related Kubeletto Features

Kubeletto offers automatic SSL certificate provisioning, zero-downtime rollbacks, and scale-to-zero autoscaling for Nuxt 3 container workloads:

GitHub Auto-Deploy Environment Variables HTTPS App Hosting

PaaS Platform Comparisons

See how Kubeletto compares directly against other cloud platforms and PaaS providers when deploying TypeScript / JavaScript workloads:

Kubeletto vs Railway Compare serverless TypeScript / JavaScript deployment workflows and scale-to-zero pricing models. Kubeletto vs Render Compare container resource allocations, deploy speeds, and TLS setup for TypeScript / JavaScript.

Frequently Asked Questions

Find direct answers to common questions about hosting, building, scaling, and managing Nuxt 3 containerized apps on Kubeletto:

Does Nuxt 3 SSR work on Kubeletto?

Yes. Nuxt 3 with the node-server preset runs its Nitro HTTP server inside the container. Kubeletto handles TLS termination and routing externally.

Can I use Nuxt 3 API routes on Kubeletto?

Yes. Nuxt server routes (server/api/*.ts) are compiled into the Nitro server bundle and run as standard HTTP handlers inside your container.

What about Nuxt 3 static generation (SSG)?

For SSG/ISR, generate your static output and serve it via nginx — same as the React static guide. Use the nuxi generate command and copy the .output/public folder to nginx.

More Deploy Guides

TypeScript / JavaScript Deploy a Next.js App TypeScript / JavaScript Deploy a React Static App Node.js Deploy a Node.js App

Deploy your Nuxt 3 app today

Free during our active beta. No credit card required.

Start Deploying Free