Docker

Since Hyperterse is a standalone binary, you can run it in a Docker container. There are no external dependencies required.

Dockerfile

Export bundle

hyperterse export -f my-query-gateway.terse -o dist

Create dockerfile

1
FROM alpine:3.19
2

3
# Install bash and ca-certificates for HTTPS database connections
4
RUN apk --no-cache add bash ca-certificates
5

6
WORKDIR /app
7

8
# Copy exported bundle
9
COPY dist/my-query-gateway /app/my-query-gateway
10

11
# Make script executable
12
RUN chmod +x /app/my-query-gateway
13

14
EXPOSE 8080
15

16
CMD ["/app/my-query-gateway"]

Build image
Terminal window
```
docker build -t my-query-gateway-app .
```

Run container

docker run -d \
  -p 8080:8080 \
  -e DATABASE_URL="postgresql://user:pass@host:5432/db" \
  --name hyperterse \
  my-query-gateway-app

Docker Compose

Create docker-compose.yml

1
version: '3.8'
2

3

4
 services:
5
   my-query-gateway:
6
     build: .
7
     ports: - '8080:8080'
8
     environment: - DATABASE_URL=postgresql://user:pass@localhost:5432/app
9
     depends_on: - postgres
10
     restart: unless-stopped
11

12
 # For local development with database
13
 postgres:
14
     image: postgres:16
15
     environment: - POSTGRES_USER=user - POSTGRES_PASSWORD=pass - POSTGRES_DB=app
16
     volumes: - postgres_data:/var/lib/postgresql/data
17
     ports: - '5432:5432'
18

19
 volumes:
20
   postgres_data:

Start services
Terminal window
```
docker-compose up -d
```

Environment variables

Pass credentials via environment:

docker run -d \
  -p 8080:8080 \
  -e DATABASE_URL="${DATABASE_URL}" \
  -e REDIS_URL="${REDIS_URL}" \
  my-query-gateway-app

Or use .env file:

docker run -d \
  -p 8080:8080 \
  --env-file .env.production \
  my-query-gateway-app

Health checks

1
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
2
  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/heartbeat || exit 1

Note: If using Alpine, install wget or use curl instead:

1
RUN apk --no-cache add bash ca-certificates wget
2
# or
3
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
4
  CMD curl -f http://localhost:8080/heartbeat || exit 1