Iso is a plug-and-play dashboard for all your self-hosted services. Built for my personal homelab — now open-sourced for yours.

• Fully configurable through a single config.json file
• Multi-language: English, Español, Français, Deutsch
• Icon ready: choose from a set of built-in icons or supply your own
• Docker-first: run anywhere with one simple command

docker run -d \
 --name iso \
 -p 3000:3000 \
 -e AUTH_SECRET="changeme" \
 -e AUTH_PASSWORD="changeme" \
 -v ./config:/config \
 coyann/iso

services:
 iso:
 image: coyann/iso:latest
 container_name: iso
 ports:
 - "3000:3000"
 environment:
 - AUTH_SECRET=changeme
 - AUTH_PASSWORD=changeme
 volumes:
 - ./config:/config
 restart: unless-stopped

Open http://localhost:3000 and you're up and running!

Iso is configured through a single config.json file located in the /config directory.

{
 "title": "My Dashboard",
 "services": [
 {
 "order": 1,
 "icon": "tv",
 "label": "Plex",
 "href": "https://plex.example.com"
 },
 {
 "order": 2,
 "icon": "lock",
 "label": "Bitwarden",
 "href": "https://vault.example.com"
 }
 ],
 "locale": "en",
 "theme": "amethyst",
 "greetings": [],
 "pageLoadAnimation": true,
 "search": {
 "enabled": true,
 "engine": "google",
 "engineUrl": "",
 "placeholder": "Search ..."
 }
}

• title: Dashboard title displayed in the header
• services: Array of service objects with:
  • order: Display order (number)
  • icon: Icon name from built-in set
  • label: Service display name
  • href: Service URL
• locale: Language code (en, es, fr, de)
• theme: Color theme (e.g., amethyst)
• greetings: Custom greeting messages
• pageLoadAnimation: Enable/disable page animations
• search: Object containing search bar settings
  • enabled: Toggle visibility of the search bar
  • engine: Built-in search engine (google, bing, duckduckgo, startpage, qwant, searx, or custom)
  • engineUrl: Custom search engine URL. Use [q] as placeholder for the search query.
  • placeholder: Input placeholder text shown in the search bar

• Nix

Or

• The Bun JavaScript runtime

1. Clone the repository:

git clone https://github.com/Coyenn/iso.git
cd iso

2. Install dependencies:

bun install

3. Start the development server:

bun dev

4. Open http://localhost:3000 in your browser

Distributed under the MIT License. See LICENSE for more information.