> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringee.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker (Standalone)

> Run Ringee with standalone Docker containers

> [!WARNING]
>
> This method is for **advanced users** who want granular control over each container. For most users, we recommend using [Docker Compose](https://docs.ringee.io/installation/docker-compose.md) instead.

## Prerequisites

* [Docker](https://docs.docker.com/get-docker/) installed
* A running **PostgreSQL** instance
* A running **Redis** instance
* API keys for required services (see [Configuration Reference](https://docs.ringee.io/configuration/reference.md))

## Setup external services

If you don't already have PostgreSQL and Redis running, start them with Docker:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
# PostgreSQL
docker run -d \
  --name ringee-db \
  -e POSTGRES_USER=ringee-user \
  -e POSTGRES_PASSWORD=ringee-password \
  -e POSTGRES_DB=ringee-db-local \
  -p 5432:5432 \
  postgres:16

# Redis
docker run -d \
  --name ringee-redis \
  -p 6379:6379 \
  redis:7-alpine
```

## Build the Docker image

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
git clone https://github.com/ringee-io/ringee-app.git
cd ringee
docker build -t ringee .
```

## Run the services

### Backend

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
docker run -d \
  --name ringee-backend \
  --env-file .env \
  -e DATABASE_URL="postgresql://ringee-user:ringee-password@host.docker.internal:5432/ringee-db-local?schema=public" \
  -e REDIS_URL="redis://host.docker.internal:6379" \
  -p 3000:3000 \
  ringee backend
```

### Worker

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
docker run -d \
  --name ringee-worker \
  --env-file .env \
  -e DATABASE_URL="postgresql://ringee-user:ringee-password@host.docker.internal:5432/ringee-db-local?schema=public" \
  -e REDIS_URL="redis://host.docker.internal:6379" \
  ringee worker
```

### Frontend

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
docker run -d \
  --name ringee-frontend \
  --env-file .env \
  -p 4200:4200 \
  ringee frontend
```

## Verify

Check all containers are running:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
docker ps --filter "name=ringee"
```

Then open:

* **Frontend** → [http://localhost:4200](http://localhost:4200)
* **Backend API** → [http://localhost:3000/api](http://localhost:3000/api)

## Next steps

> [card] [Configuration](https://docs.ringee.io/configuration/reference.md)
>
> Full environment variable reference

> [card] [Telnyx Setup](https://docs.ringee.io/providers/telnyx.md)
>
> Configure telephony


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.