seatsurfing/backend repository overview

⁠Seatsurfing Backend

Seat booking server software which enables your organisation's employees to book seats, desks and rooms.

⁠Quick reference

• Maintained by: Seatsurfing.io⁠
• Where to get help: Documentation⁠
• Supported architectures: amd64, arm64
• License: GPL 3.0⁠

⁠How to use this image

⁠Start using Docker Compose

services:
  server:
    image: ghcr.io/seatsurfing/backend
    restart: always
    networks:
      sql:
    ports:
      - 8080:8080
    environment:
      POSTGRES_URL: 'postgres://seatsurfing:DB_PASSWORD@db/seatsurfing?sslmode=disable'
      CRYPT_KEY: 'some-random-32-bytes-long-string'
  db:
    image: postgres:17
    restart: always
    networks:
      sql:
    volumes:
      - db:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: DB_PASSWORD
      POSTGRES_USER: seatsurfing
      POSTGRES_DB: seatsurfing

volumes:
  db:

networks:
  sql:

This starts...

• a PostgreSQL database with data stored on Docker volume "db"
• a Seatsurfing instance with port 8080 exposed

The Seatsurfing Booking UI is accessible at :8080/ui/search/ and the Seatsurfing Admin UI instance at :8080/ui/admin/.

To login, use the default admin login (user [email protected] and password 12345678) or set the environment variables⁠ INIT_ORG_USER and INIT_ORG_PASS to customize the admin login.

⁠Running on Kubernetes

Please refer to our Kubernetes documentation⁠.

⁠⚙️ Environment variables

Please check out the documentation⁠ for information on available environment variables and further guidance.

Hint: When running in an IPV6-only Docker/Podman environment with multiple network interfaces bound to the Frontend containers, setting the LISTEN_ADDR environment variable can be necessary as NextJS binds to only one network interface by default. Set it to :: to bind to any address.