Deploy recipes: copy, deploy, open

# Skip this if you already have a React project
npm create vite@9.2.1 my-site -- --template react
cd my-site
npm install

my-site/
├── Dockerfile       ← new
├── nginx.conf       ← new
├── inquir.yaml      ← new
├── package.json
├── package-lock.json
├── index.html
└── src/

# Step 1: build the site with Node.js
FROM node:22.23.4-alpine@sha256:fe4f6d74e20370acb04ad889077d14d0f64a9c8ea6a42bc60cddf1e844699914 AS build
WORKDIR /app
COPY package*.json ./
RUN if [ -f package-lock.json ]; then npm ci; else npm install; fi
COPY . .
# Vite writes the finished site to dist/
RUN npm run build

# Step 2: serve the finished files with nginx (runs as a regular user, port 8080)
FROM nginxinc/nginx-unprivileged:1.30.6-alpine@sha256:f5116ed4606f3eb015dd4a8e28cb9b351476dc0ad4bc6e9f93b19cec130cdf03
COPY nginx.conf /etc/nginx/conf.d/default.conf
COPY --from=build /app/dist/ /usr/share/nginx/html/
EXPOSE 8080

server {
    listen 8080;                 # the same port as runtime.port in inquir.yaml
    server_name _;
    root /usr/share/nginx/html;
    index index.html;
    absolute_redirect off;

    # Compress text files. gzip_proxied is needed: requests reach nginx through a proxy.
    gzip on;
    gzip_proxied any;
    gzip_vary on;
    gzip_types text/css application/javascript text/javascript application/json image/svg+xml text/plain;

    # Health check: the platform calls it before sending visitors to a new version.
    location = /healthz {
        access_log off;
        default_type text/plain;
        return 200 "ok\n";
    }

    # Files in /assets/ have a hash in their names: browsers may keep them for a year.
    location /assets/ {
        add_header Cache-Control "public, max-age=31536000, immutable";
        try_files $uri =404;
    }

    # Any other path: the file if it exists, otherwise index.html (React Router links work).
    location / {
        add_header Cache-Control "no-cache";
        try_files $uri $uri/ /index.html;
    }
}

version: 1
services:
  web:                      # always "web"
    runtime:
      port: 8080            # the port nginx listens on (nginx.conf)
      healthcheck:
        type: http
        path: /healthz
      resources:            # plenty for a static site
        cpuVCpus: 0.25
        memoryMb: 128

# In the my-site folder
inquir apps create my-site --ingress public   # once: a new app with a public address
inquir apps deploy my-site --promote          # build, start, then send visitors to it

# Build succeeded in 34692ms
# Release ef51e99f is serving
# Production now serves ef51e99f
#   https://my-site-2mk7b4.apps.inquir.org      <- your site

# After every change: the same command
inquir apps deploy my-site --promote

# Prints two DNS records to add where you bought the domain
inquir apps domain my-site www.example.com
# Once the records are live: the site answers on your domain, with HTTPS
inquir apps domain my-site www.example.com --verify

my-page/
├── Dockerfile
├── inquir.yaml
└── public/          ← your site: index.html, CSS, images, JS
    ├── index.html
    └── style.css

# nginx that runs as a regular user and listens on port 8080
FROM nginxinc/nginx-unprivileged:1.30.6-alpine@sha256:f5116ed4606f3eb015dd4a8e28cb9b351476dc0ad4bc6e9f93b19cec130cdf03
# Your site: everything in the public/ folder
COPY public/ /usr/share/nginx/html/
EXPOSE 8080

version: 1
services:
  web:                      # always "web"
    runtime:
      port: 8080            # nginx listens here
      healthcheck:
        type: http
        path: /             # the home page must answer
      resources:
        cpuVCpus: 0.25
        memoryMb: 128

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>My site</title>
    <link rel="stylesheet" href="/style.css" />
  </head>
  <body>
    <h1>Hello from Inquir Compute</h1>
    <p>Edit public/index.html and deploy again.</p>
  </body>
</html>

# In the my-page folder
inquir apps create my-page --ingress public
inquir apps deploy my-page --promote
#   https://my-page-6w79j4.apps.inquir.org      <- your site

{
  "name": "my-api",
  "private": true,
  "type": "module",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^5.2.1"
  }
}

import express from 'express';

const app = express();
app.use(express.json());

// Health check: the platform calls it before sending traffic to a new version.
app.get('/healthz', (req, res) => res.send('ok'));

app.get('/api/hello', (req, res) => {
  res.json({ message: 'Hello from Inquir Compute', time: new Date().toISOString() });
});

// The platform sets PORT to runtime.port from inquir.yaml.
const port = Number(process.env.PORT) || 3000;
const server = app.listen(port, () => console.log(`listening on ${port}`));

// Finish open requests before a new version replaces this one.
process.on('SIGTERM', () => server.close(() => process.exit(0)));

FROM node:22.23.4-alpine@sha256:fe4f6d74e20370acb04ad889077d14d0f64a9c8ea6a42bc60cddf1e844699914
WORKDIR /app
ENV NODE_ENV=production
COPY package*.json ./
RUN if [ -f package-lock.json ]; then npm ci --omit=dev; else npm install --omit=dev; fi
COPY . .
# Run as the regular "node" user that the image ships with
USER node
EXPOSE 3000
CMD ["node", "server.js"]

version: 1
services:
  web:                      # always "web"
    runtime:
      port: 3000            # the port server.js listens on
      healthcheck:
        type: http
        path: /healthz
      resources:
        cpuVCpus: 0.25
        memoryMb: 256

# In the my-api folder (npm install once, so package-lock.json exists)
inquir apps create my-api --ingress public
inquir apps deploy my-api --promote

curl https://my-api-88n5um.apps.inquir.org/api/hello
# {"message":"Hello from Inquir Compute","time":"2026-10-22T18:16:37.443Z"}

fastapi==0.141.1
uvicorn[standard]==0.54.0

from datetime import datetime, timezone

from fastapi import FastAPI

app = FastAPI()


# Health check: the platform calls it before sending traffic to a new version.
@app.get("/healthz")
def healthz():
    return {"ok": True}


@app.get("/api/hello")
def hello():
    return {"message": "Hello from Inquir Compute", "time": datetime.now(timezone.utc).isoformat()}

FROM python:3.12.15-slim@sha256:cb33f7f771ecec2ef1225cf39b159591a040391bd73e4c01f00fdfc4c47611d2
ENV PYTHONUNBUFFERED=1 PIP_NO_CACHE_DIR=1 PIP_DISABLE_PIP_VERSION_CHECK=1
WORKDIR /app
COPY requirements.txt ./
RUN pip install -r requirements.txt
COPY . .
# Run as a regular user, not root
RUN useradd --create-home --uid 10001 app
USER app
EXPOSE 8000
# The platform sets PORT to runtime.port from inquir.yaml
CMD ["sh", "-c", "exec uvicorn main:app --host 0.0.0.0 --port ${PORT:-8000} --proxy-headers --forwarded-allow-ips='*'"]

version: 1
services:
  web:                      # always "web"
    runtime:
      port: 8000            # the port uvicorn listens on
      healthcheck:
        type: http
        path: /healthz
      resources:
        cpuVCpus: 0.25
        memoryMb: 256

# In the my-api folder
inquir apps create my-api --ingress public
inquir apps deploy my-api --promote

curl https://my-api-uqprbk.apps.inquir.org/api/hello
# {"message":"Hello from Inquir Compute","time":"2026-10-22T18:16:43.033814+00:00"}

// npm install pg
import pg from 'pg';

const db = new pg.Pool({ connectionString: process.env.DATABASE_URL, max: 5 });

app.get('/api/db', async (req, res) => {
  const { rows } = await db.query('select now() as now, version() as version');
  res.json(rows[0]);
});

# requirements.txt: psycopg[binary]==3.3.6
import os

import psycopg


@app.get("/api/db")
def db_time():
    with psycopg.connect(os.environ["DATABASE_URL"]) as conn:
        now, version = conn.execute("select now(), version()").fetchone()
    return {"now": now.isoformat(), "version": version}

# A Postgres 16 database with its own disk, in the same project as my-api
# (inquir apps create my-api printed the project's name)
inquir apps create my-db --template postgres --project <project>

# Hand my-api the address: DATABASE_URL appears in its variables.
# "no verified private address yet"? Wait a minute and run it again.
inquir apps connect my-db my-api

# In the my-api folder: the new code picks DATABASE_URL up
inquir apps deploy my-api --promote

curl https://my-api-88n5um.apps.inquir.org/api/db
# {"now":"2026-10-22T18:21:23.413Z","version":"PostgreSQL 16.15 on x86_64-pc-linux-musl, ..."}

# Later, after changing only a variable (not the code): inquir apps redeploy my-api