Homarr iFrames

Homarr iFrames is a small Go-based API that generates embeddable HTML iFrames for a variety of self-hosted applications so they can be displayed inside dashboards (not limited to Homarr). The API exposes per-source routes that produce HTML iFrames and accepts query parameters to control output and reload behavior.

Key Features

• Generates embeddable iFrame endpoints for many sources (examples: Linkwarden, Vikunja).
• Per-source query parameters (limit, collectionId, theme, auto-reload) to customize the returned HTML.
• Built-in API documentation served via Swagger at /v1/swagger/index.html.
• Distributed as a Docker image and includes a Dockerfile and docker-compose example; default container port is 8080.
• Simple, dependency-light Go implementation suitable for running behind a reverse proxy.

Use Cases

• Embed bookmarks, task lists or other self-hosted app views inside a Homarr or custom dashboard.
• Provide lightweight, customizable HTML widgets for private dashboards without modifying the upstream apps.
• Combine multiple service-specific iFrames into a single dashboard page for consolidated monitoring.

Limitations and Considerations

• No built-in authentication or access control: any client that can reach the API can request iFrame content; run behind an auth/reverse-proxy (e.g., Authelia/Authentik) or restrict network access.
• iFrame behavior depends on the browser and the target app (mixed HTTP/HTTPS contexts or apps sending X-Frame-Options may block embedding).
• Feature set is focused on producing and customizing HTML iFrames rather than acting as a full integration layer (some sources may require specific environment variables).

Homarr iFrames is a compact, practical solution for exposing many self-hosted app views as embeddable iFrames for dashboards. It is implemented in Go and intended to be run in containers or directly with minimal dependencies.