Customizing the application's style and icon

Changing application colors

1. Download a copy of overrides.css.
2. Uncomment the CSS and customize it to match your desired colors.
3. Make a bind mount from this file to the container's /app/static/overrides.css:
   • Plain Docker

     docker run \
     -v planning-poker-data:/data \
     -v /path/to/overrides.css:/app/static/overrides.css \
     -p 8000:8000 \
     axeleroy/self-host-planning-poker:latest

   • Docker Compose

     version: "3"
     services:
       planning-poker:
         image: axeleroy/self-host-planning-poker:latest
         ports:
         - 8000:8000
         volumes:
         - planning-poker-data:/data
         - /path/to/overrides.css:/app/static/overrides.css
     
     volumes:
       planning-poker-data: {}

Changing application icon

⚠️ This will only change the icon displayed in the application's navigation bar. To change the favicon, refer to the next section

Make a bind mount from your desired icon to the container's /app/static/assets/icon.svg:

• Plain Docker

  docker run \
  -v planning-poker-data:/data \
  -v /path/to/icon.svg:/app/static/assets/icon.svg \
  -p 8000:8000 \
  axeleroy/self-host-planning-poker:latest

• Docker Compose

  version: "3"
  services:
    planning-poker:
      image: axeleroy/self-host-planning-poker:latest
      ports:
      - 8000:8000
      volumes:
      - planning-poker-data:/data
      - /path/to/icon.svg:/app/static/assets/icon.svg
  
  volumes:
    planning-poker-data: {}

Changing application favicon

1. Use Favicon Generator to generate a "Favicon package"
2. Unzip the downloaded package.
3. Make a bind mount from the unziped folder to the container's /app/static/assets/favicon:
   • Plain Docker

     docker run \
     -v planning-poker-data:/data \
     -v /path/to/folder:/app/static/assets/favicon \
     -p 8000:8000 \
     axeleroy/self-host-planning-poker:latest

   • Docker Compose

     version: "3"
     services:
       planning-poker:
         image: axeleroy/self-host-planning-poker:latest
         ports:
         - 8000:8000
         volumes:
         - planning-poker-data:/data
         - /path/to/folder:/app/static/assets/favicon
     
     volumes:
       planning-poker-data: {}