Iso

Iso is a lightweight, plug-and-play dashboard for organising and launching your self-hosted services. It is aimed at homelab and personal server users and is configured through a single JSON file for easy setup and portability.

Key Features

• Single-file configuration: define the dashboard (title, services, order, icons, links) in a single config.json.
• Docker-first distribution with a ready Docker image and an example Docker Compose configuration for quick deployment.
• Multi-language UI: built-in support for English, Español, Français and Deutsch.
• Themeable appearance and icon-ready service entries with optional custom icons and greeting messages.
• Search bar support with configurable search engine (multiple engines supported or custom engineUrl placeholder).

Use Cases

• Personal homelab startpage: centralise links to web UIs (Plex, Bitwarden, Home Assistant, etc.) for quick access.
• Small team or household launcher: expose commonly used self-hosted tools behind one minimal dashboard.
• Lightweight public-facing service index (internal network): provide a branded entrypoint for services without a heavy control panel.

Limitations and Considerations

• Manual configuration: services must be declared in config.json; there is no automatic service discovery or dynamic health checking built-in.
• Lightweight feature set: Iso focuses on linking and launching services rather than offering integrated monitoring, metrics, or advanced user-management features.
• Opinionated deployment: project assumes containerized deployment (Docker) and development tooling such as Bun or Nix for local development as noted in the repository.

Iso is intentionally minimal and focused on being an easy-to-configure dashboard for self-hosted services. It is suitable for users who want a simple, themeable startpage with Docker-based deployment and straightforward JSON configuration.