Glance

GitHub stats

Stars

37,610

Forks

1,497

Open issues and pull requests

322

Last push

2026-10-20

Latest release

v0.8.7

Released

2026-10-15

From the GitHub API on 2026-10-22. These numbers are a snapshot, not live. GitHub detected the license as AGPL-3.0.

Compose file

services:
  glance:
    container_name: glance
    image: glanceapp/glance
    restart: unless-stopped
    volumes:
      - ./config:/app/config
      - ./assets:/app/assets
      - /etc/localtime:/etc/localtime:ro
      # Optionally, also mount docker socket if you want to use the docker containers widget
      # - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - 8080:8080
    env_file: .env

From a separate packaging repository: github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml.

Compose file from glanceapp/docker-compose-template, used inside a checkout of that repository (documented setup B).

Install

1. Docker with the Compose plugin and git (github.com/glanceapp/glance/blob/8958aa8/README.md)

   A host with Docker, the Docker Compose plugin and git. This entry needs a checkout of the project repository.

2. Get the source at commit 1b0af54 (github.com/glanceapp/glance/blob/8958aa8/README.md)

   git init docker-compose-template
   cd docker-compose-template
   git remote add origin https://github.com/glanceapp/docker-compose-template.git
   git sparse-checkout init --cone
   git sparse-checkout set root
   git fetch --depth 1 --filter=blob:none origin 1b0af54f831f26bc01873514a52be3d393665e06
   git checkout FETCH_HEAD

3. Go to the folder the docs use (github.com/glanceapp/glance/blob/8958aa8/README.md)

   cd root

4. The compose file in the checkout: root/docker-compose.yml (shown here for reading) (github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml)

   Use the compose file shown above.

5. What the compose file check ran with (github.com/glanceapp/glance/blob/8958aa8/README.md)

   The compose file check ran in a checkout of glanceapp/docker-compose-template at 1b0af54f831f26bc01873514a52be3d393665e06 (a sparse checkout: the top-level files and the folder root), in the folder root. The README tells the reader to create a glance folder from the files of the docker-compose-template repository, edit docker-compose.yml and the config files as needed and run docker compose up -d.

6. Start it (github.com/glanceapp/glance/blob/8958aa8/README.md)

   docker compose up -d

7. Open the app (github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml)

   Open http://localhost:8080. The compose file publishes host port 8080 for the glance service.

Compose file check: config_ok on 2026-10-22.

Gotchas and maintenance

Gotchas

• Some images use the latest tag or no tag. Images without a pinned version: glance: glanceapp/glance (no tag). A later pull can get a different version. (github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml, checked 2026-10-22)
• The compose file publishes host ports. Host ports: 8080 (glance). A port without a host address listens on all host network interfaces. (github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml, checked 2026-10-22)
• The compose file mounts host folders. Host paths mounted into containers: ./config at /app/config (glance), ./assets at /app/assets (glance), /etc/localtime at /etc/localtime (glance). (github.com/glanceapp/docker-compose-template/blob/1b0af54/root/docker-compose.yml, checked 2026-10-22)

Signals

• Open issues and pull requests: 322
• Last push: 2026-10-20 (2 days before this page was built)
• Latest release: v0.8.7 on 2026-10-15 (7 days before this page was built)