Quickstart

Deploy your first app in 60 seconds. No configuration files, no Docker Compose, no Kubernetes manifests. Just point Temps at your Git repo and deploy.

Prerequisites

Before you begin, make sure you have:

Docker installed and running
A GitHub or GitLab account with a repository to deploy

Step 1: Start PostgreSQL with TimescaleDB

Temps requires PostgreSQL with TimescaleDB. Run this one-time setup:

# Create a persistent volume for your database
docker volume create temps-postgres

# Start TimescaleDB (runs on port 16432 to avoid conflicts)
docker run -d \
  --name temps-postgres \
  -v temps-postgres:/var/lib/postgresql/data \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=temps \
  -e POSTGRES_DB=temps \
  -p 16432:5432 \
  timescale/timescaledb:latest-pg18

Step 2: Install Temps

Choose your installation method:

brew tap gotempsh/tap && brew install temps

Verify the installation:

temps --version

Step 3: Start Temps

temps serve \
  --address 0.0.0.0:8080 \
  --database-url postgresql://postgres:temps@localhost:16432/temps

Open http://localhost:8080 in your browser.

Step 4: Complete the Onboarding

Create your admin account - Follow the on-screen wizard
Connect your Git provider - Click "Connect GitHub" or "Connect GitLab"
Authorize Temps - Grant access to your repositories

Step 5: Deploy Your First App

Go to Projects → New Project
Select your repository from the list
Choose the branch to deploy (e.g., main)
Click Deploy

That's it! Watch the build logs in real-time. Your app will be live in ~30-60 seconds with:

HTTPS (automatic TLS certificates)
Analytics (visitor tracking, page views)
Error tracking (Sentry-compatible)
Monitoring (uptime checks)
Live logs (real-time container logs)

What Gets Auto-Detected?

Temps automatically detects your framework and configures the build:

Framework	Build Command	Start Command
Next.js	`npm run build`	`npm start`
Vite/React	`npm run build`	Static serve
Node.js	`npm install`	`npm start`
Python	`pip install -r requirements.txt`	`uvicorn main:app`
Go	`go build`	Binary execution
Static HTML	None	nginx serve

For custom applications, just add a Dockerfile to your repository.

Example: Deploy a Next.js App

# Your repository structure
my-nextjs-app/
├── package.json
├── next.config.js
└── pages/
    └── index.tsx

# Temps auto-detects and deploys with:
# - Build command: npm run build
# - Start command: npm start
# - Port: 3000 (auto-detected)

Next Steps

Now that your app is deployed:

Add a custom domain - Go to Project Settings → Domains
Set environment variables - Go to Project Settings → Environment Variables
View analytics - Check the Analytics tab in your project
Set up error tracking - Get your DSN from Error Tracking → DSN & Setup

For a more detailed installation guide with production configuration, see the Installation page.