Installation¶

This guide covers different installation methods for Tempo.

Installation Methods¶

The easiest way to run Tempo is with Docker Compose. See the Quick Start Guide for detailed instructions.

For development or if you prefer to run services individually:

If you don't have PostgreSQL installed locally, you can use Docker Compose to run only the database:

docker-compose up -d postgres

Or install PostgreSQL locally and create a database:

createdb tempo

Update api/appsettings.json with your database connection string:

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Port=5432;Database=tempo;Username=postgres;Password=postgres"
  }
}

cd api
dotnet ef database update

cd api
dotnet watch run

The API will run at http://localhost:5001. Swagger UI is available at /swagger in Development mode.

In a new terminal:

cd frontend
npm install
npm run dev

The frontend will run at http://localhost:3000.

For production deployment, see the Production Deployment Guide.

Default ports used by Tempo:

You can change these ports in docker-compose.yml if needed.