Deployment

Guidelines for deploying applications powered by an5 ORM across cloud providers and containerized environments.

Active Context: Deploying Typescript application with Sqlite database.

Production Checklist

Before going live:

  • Set DATABASE_URL securely via cloud environment secrets manager.
  • Configure connection pooling limits appropriate for your container concurrency.
  • Enable TLS/SSL connection encryption (sslmode=require, encrypt=true).
  • Run automated health check before accepting traffic.
  • Verify automated database backup and disaster recovery schedules.

Environment Configuration

Production Connection String

Set DATABASE_URL according to your target cloud database provider:

# Production DATABASE_URL (Active: Sqlite)
DATABASE_URL=sqlite:///data/production.db

# Application environment
NODE_ENV=production
LOG_LEVEL=warn

Runtime Initialization

import { createAn5Adapter } from "@an5/adapters";

const db = createAn5Adapter({
  connectionString: process.env.DATABASE_URL!,
});

await db.$connect();

Container Deployment (Docker)

Multi-stage Dockerfile tailored for your stack:


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

FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/index.js"]


Next Steps