docker-compose.yaml

# This is used by my editors LSP for autocomplete
# yaml-language-server: $schema=https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema/compose-spec.json

# This specifies the networks our containers are going to use.
# We are only using one network since this mostly for development, and it just keeps things tidy
networks:
  app_network:
    driver: bridge

# This is a named volume. It is used because of a an issue I was facing with permissions when mounting a volume for the database
volumes:
  pgdata:
  minio_data:
  mc_data:

# Specifies the services that Docker Compose will start if we run this compose file
services:
  # This service is the web app. For the source code, checkout the web directory
  web:
    # This specifies the docker file/context to build for the web app container
    build:
      context: .
      dockerfile: ./web/dev.Dockerfile
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    volumes:
      - ./pnpm-lock.yaml:/app/pnpm-lock.yaml
      - ./web:/app/web
      - /app/node_modules
      - /app/web/node_modules
    # Expose the port that the web app uses so you can access it at localhost:3000
    ports:
      - 3000:3000
    # Use the .env file from the web dir
    env_file:
      - ./web/.env
    environment:
      CHOKIDAR_USEPOLLING: true
    # This container will wait for the api container to start before starting
    depends_on:
      - api
    # This is used for dev purposes so we can auto reload containers wehen files change
    develop:
      watch:
        - path: ./web/package.json
          action: rebuild
  # This service is the api. For the source code, checkout the api directory
  api:
    # This specifies the docker file/context to build for the api container
    build:
      context: ./api
      dockerfile: dev.Dockerfile
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # Expose the port that the api uses so you can access it at localhost:8000
    ports:
      - 8000:8000
    # Use the .env file from the api dir
    env_file:
      - ./api/.env
    # This container will wait for the db container to start before starting
    depends_on:
      - db
      - object-storage
    links:
      - db:postgres
      - object-storage:minio
    # This is used for dev purposes so we can auto reload containers wehen files change
    develop:
      watch:
        - path: ./api/go.mod
          action: rebuild
        - path: ./api
          target: /app
          action: sync+restart
  # This service is the database
  db:
    # We are using the PostgreSQL v16 image for this container
    image: postgres:16
    # Expose the default port for if we need to access the database from tools outside the docker context
    ports:
      - 5432:5432
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    restart: unless-stopped
    # Mount a local volume so the db data will persist on your local machine
    volumes:
      # pgdata is a dedicated volume mount specified earlier in the file under `volumes:`
      - pgdata:/var/lib/postgresql/data
    # Some environment variables to get this container up and running
    environment:
      POSTGRES_PASSWORD: postgres
      POSTGRES_USER: postgres
      POSTGRES_DB: forkd
  object-storage:
    image: minio/minio:RELEASE.2025-06-13T11-33-47Z
    command: server --console-address ":9001" /data
    ports:
      - "9000:9000"
      - "9001:9001"
    networks:
      - app_network
    volumes:
      - "minio_data:/data"
    environment:
      - MINIO_ROOT_USER=minio
      - MINIO_ROOT_PASSWORD=minio-password
      - MINIO_DEFAULT_BUCKETS=forkd
  # A web admin for postgres
  pgweb:
    # Use the docker image for this web admin
    image: sosedoff/pgweb:0.16.2
    restart: unless-stopped
    # Expose port 8081 to the local machine so you can access it at localhost:8081
    ports:
      - 8081:8081
    # This container will wait for the db container to start before starting
    depends_on:
      - db
    links:
      - db:postgres
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # Environment variables the pgweb container needs to communicate with out database
    environment:
      PGWEB_DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres?sslmode=disable
  # All services below here are used for one off script runs
  # A container to run database migrations
  gqlgen:
    # Use the gqlgen.Dockerfile for this script
    build:
      context: ./api
      dockerfile: gqlgen.Dockerfile
    # Never restart this container
    restart: no
    # Mount our migrations directory so the geni cli can access those files
    volumes:
      - ./api/graph:/app/graph
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # This is important, we assign a profile so this container doesn't auto start when you run `docker-compose start`
    profiles:
      - "scripts"
  # A container to run database migrations
  migrate:
    # Use the `migrate` docker image for https://github.com/golang-migrate/migrate
    image: migrate/migrate:4
    # Never restart this container
    restart: no
    # This container will wait for the db container to start before starting
    depends_on:
      - db
    links:
      - db:postgres
    # Some environment variables required for the geni cli to function
    environment:
      DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres?sslmode=disable
    # Mount our migrations directory so the geni cli can access those files
    volumes:
      - ./db/migrations/:/migrations
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # This is important, we assign a profile so this container doesn't auto start when you run `docker-compose start`
    profiles:
      - "scripts"
  # A container to run SQLc gen
  sqlc:
    # Use the `sqlc` docker image for https://docs.sqlc.dev/en/stable/overview/install.html#docker
    image: sqlc/sqlc:1.28.0
    # Never restart this container
    restart: no
    # This container will wait for the db container to start before starting
    depends_on:
      - db
    links:
      - db:postgres
    # Mount our db and app directories so the sqlc cli can access those files
    volumes:
      - ./db/:/db
      - ./api:/app
    working_dir: /app
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # This is important, we assign a profile so this container doesn't auto start when you run `docker-compose start`
    profiles:
      - "scripts"
  mc:
    image: minio/mc:RELEASE.2025-05-21T01-59-54Z
    restart: no
    depends_on:
      - object-storage
    links:
      - object-storage:minio
    networks:
      - app_network
    volumes:
      - "minio_data:/root/.mc"
    profiles:
      - "scripts"
  # Container to run golangci-lint
  golangci-lint:
    image: golangci/golangci-lint:v2.2.1-alpine
    restart: no
    volumes:
      - ./api:/app
    working_dir: /app
    profiles:
      - "scripts"
  gofmt:
    image: golang:1.23-alpine
    restart: no
    volumes:
      - ./api:/app
    working_dir: /app
    profiles:
      - "scripts"
  eslint:
    build:
      context: .
      dockerfile: ./eslint.Dockerfile
    restart: no
    volumes:
      - ./:/app
    profiles:
      - "scripts"
  prettier:
    build:
      context: .
      dockerfile: ./prettier.Dockerfile
    restart: no
    volumes:
      - ./:/app
    profiles:
      - "scripts"
  sqlfluff:
    image: sqlfluff/sqlfluff:3.4.2
    restart: no
    volumes:
      - ./db:/db
    working_dir: /db
    profiles:
      - "scripts"
  seed:
    # This specifies the docker file/context to build for the api container
    build:
      context: ./api
      dockerfile: seed.Dockerfile
    # Attach this container to our dedicated network for the services in this compose file
    networks:
      - app_network
    # Expose the port that the api uses so you can access it at localhost:8000
    # Use the .env file from the api dir
    env_file:
      - ./api/.env
    # This container will wait for the db container to start before starting
    depends_on:
      - db
      - object-storage
    links:
      - db:postgres
      - object-storage:minio
    profiles:
      - "scripts"
  commitizen:
    # This specifies the docker file/context to build for the api container
    build:
      context: .
      dockerfile: commitizen.Dockerfile
    volumes:
      - .:/app
    profiles:
      - "scripts"