Installation

Page Goal

Provide a comprehensive installation guide for users who need more detailed setup instructions than the quickstart. Cover multiple installation methods, troubleshooting, and system requirements to ensure successful setup.

Target Persona

Setup Steve - A developer or DevOps engineer who:

  • Needs production-ready installation (not just quick trial)
  • May be setting up for a team or organization
  • Wants to understand system requirements and architecture
  • Experience level: Comfortable with Linux, Docker, networking
  • Has specific infrastructure constraints (firewall, proxy, etc.)
  • Values: Reliability, security, proper configuration
  • Needs: Multiple installation options, troubleshooting guidance
  • Timeline: Willing to spend 15-30 minutes for proper setup

Key Content to Include

1. System Requirements

Minimum specs

  • CPU: 2 cores
  • RAM: 4GB
  • Disk: 20GB

Recommended specs for production

  • CPU: 4 cores
  • RAM: 8GB
  • Disk: 40GB

Supported operating systems

  • Linux
  • macOS

Required ports and networking

  • HTTP: 80
  • HTTPS: 443
  • PostgreSQL: 5432

2. Installation Methods

  • Installation script
  • HomeBrew
  • Manual installation

Docker

First we need to install TimescaleDB container.

# Set environment variables
export TIMESCALE_DB_NAME=temps_production
export TIMESCALE_DB_USER=temps_admin
export TIMESCALE_DB_PASSWORD=your_secure_password_here

# Create network and volume
docker network create timescale_network
docker volume create timescaledb_data

# Run the container
docker run -d \
  --name timescaledb \
  --restart unless-stopped \
  --network timescale_network \
  -p 5452:5432 \
  -e POSTGRES_DB=$TIMESCALE_DB_NAME \
  -e POSTGRES_USER=$TIMESCALE_DB_USER \
  -e POSTGRES_PASSWORD=$TIMESCALE_DB_PASSWORD \
  -e TIMESCALEDB_TELEMETRY=off \
  -v timescaledb_data:/var/lib/postgresql/data \
  timescale/timescaledb-ha:pg17

4. Step-by-Step Installation

  • Each method with detailed commands
  • Configuration options
  • First-time setup wizard
  • Admin account creation

First, we need to install Temps, using our one-liner install script:

curl -fsSL https://temps.sh/install.sh | bash

HomeBrew

You can also install Temps using HomeBrew:

brew install temps

Then, after installing, you can run:

export POSTGRES_URL="postgres://temps_admin:your_secure_password_here@localhost:5452/temps_production"

temps-new serve \
  --address="0.0.0.0:18080" \
  --tls-address="0.0.0.0:18443" \
  --database-url=$POSTGRES_URL \
  --data-dir="./temps_data" \
  --console-address="0.0.0.0:18081"

5. Post-Installation After starting the server, you can access the dashboard at https://localhost:18081.

You can change the port and TLS port by setting the ADDRESS and TLS_ADDRESS environment variables. The recommendation for HTTP is 80 and for HTTPS is 443.

6. Troubleshooting

  • Common installation errors
  • Port conflicts
  • Permission issues
  • Docker problems

7. Next Steps

  • Connect Git provider
  • Configure email notifications
  • Set up backups
  • Deploy first application

Success Metrics

  • User successfully installs Temps on their infrastructure
  • User can access the dashboard
  • User understands how to configure Temps for their needs
  • Zero ambiguity about system requirements
  • Clear troubleshooting path for common issues

Was this page helpful?