---
project:
  name: Glance Monitor Widget Guide
  status: active
  category: documentation
  source: live-verification
  created: 2026-01-06
  updated: 2026-04-19
  description: Configuration guide for Glance Monitor widget with homelab service examples
  tags: [documentation, dashboard, glance, monitoring]
---

# Glance Dashboard Monitor Widget Configuration Guide

## Overview

The Glance Monitor widget displays service availability status by performing HTTP GET requests. Shows online/offline status and response time in milliseconds.

## Basic Configuration

```yaml
- type: monitor
  cache: 1m
  title: Services
  sites:
    - title: Jellyfin
      url: https://jellyfin.tophermayor.com
    - title: Gitea
      url: https://gitea.tophermayor.com
    - title: Immich
      url: https://immich.tophermayor.com
```

## Site-Level Properties

| Property | Required | Default | Description |
|----------|----------|---------|-------------|
| title | yes | - | Display name |
| url | yes | - | URL for link and health check |
| check-url | no | url | Separate health check URL |
| timeout | no | 3s | Response wait time |
| allow-insecure | no | false | Ignore SSL errors |
| alt-status-codes | no | - | Accept non-200 as OK |
| same-tab | no | false | Open in same tab |

## Timeout Recommendations

| Service Type | Timeout | Examples |
|-------------|---------|----------|
| Local Docker | 2s | Jellyfin, Sonarr, Radarr |
| Local VM | 3s | Proxmox, TrueNAS |
| GPU services | 10s | Immich, Ollama |

## Homelab Service Examples

```yaml
- type: monitor
  title: Core Services
  style: compact
  sites:
    - title: Authentik
      url: https://auth.tophermayor.com
      timeout: 3s
    - title: Jellyfin
      url: https://jellyfin.tophermayor.com
      timeout: 2s
    - title: Immich
      url: https://immich.tophermayor.com
      timeout: 10s
    - title: Gitea
      url: https://gitea.tophermayor.com
      timeout: 3s
    - title: Vaultwarden
      url: https://vaultwarden.tophermayor.com
      timeout: 3s

- type: monitor
  title: Infrastructure
  style: compact
  sites:
    - title: Traefik
      url: https://traefik.local.tophermayor.com/dashboard/
      timeout: 2s
    - title: Grafana
      url: https://grafana.local.tophermayor.com
      timeout: 3s
    - title: Proxmox
      url: https://proxmox.local.tophermayor.com
      timeout: 3s
```

## Troubleshooting

**Service shows offline but running:** Increase timeout, especially for GPU-accelerated services or those behind Authentik ForwardAuth.

**SSL errors:** Use `allow-insecure: true` for self-signed certificates.

**Expected auth redirects:** Use `alt-status-codes: [401, 403]` for services requiring login.

## Related

- [[../homelab/architecture.md|Homelab Architecture]]