# Dashboard Icons: A Curated Collection of 1800+ Service Icons for Self-Hosted Dashboards

> Dashboard Icons is a community-maintained repository of over 1800 SVG, PNG, and WEBP icons for services and tools, served via jsDelivr CDN with light and dark variants, and designed specifically for use in self-hosted dashboard applications.

**homarr-labs/dashboard-icons** — Your definitive source for dashboard icons.

- Repository: https://github.com/homarr-labs/dashboard-icons
- Website: https://dashboardicons.com
- Stars: 8,807 · Forks: 720
- Language: TypeScript
- License: Apache-2.0
- Published: 2026-09-10 · Updated: 2026-09-10 · Language: en
- Canonical page: https://hysenlabs.com/projects/homarr-labs-dashboard-icons

## What Dashboard Icons Provides and Who Uses It

Dashboard Icons is a curated collection of icons for services, applications, and tools that commonly appear in self-hosted home lab and server dashboards. The README describes it as your definitive source for dashboard icons, with over 1800 icons available in SVG, PNG, and WEBP formats.

The primary audience is home lab operators and developers using dashboard applications like Homarr, Homepage, or Dashy to organize links to their self-hosted services. These dashboards typically display a grid of application icons with names and URLs. Sourcing consistent, high-quality icons for those services is an unglamorous but time-consuming task. Dashboard Icons centralizes that work so it does not need to be done per deployment.

The project is hosted under the Homarr Labs GitHub organization and is related to the Homarr dashboard application, but the icons are format-agnostic and work with any dashboard that can consume URLs or downloaded files. The repository is a collection, not an application: it ships no server-side code and requires no installation for the basic CDN use case.

## CDN Integration and the Naming Convention

Icons are available directly from CDN without cloning the repository. The README documents two CDN base URLs. The recommended one is jsDelivr:

```
https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons
```

The alternative is the GitHub raw URL:

```
https://raw.githubusercontent.com/homarr-labs/dashboard-icons/main
```

Icon paths follow the pattern: /<format>/<icon-name>.<format>. For example, the Nextcloud SVG is at:



All icon names use kebab-case. The README gives the conversion rule directly: spaces and capitals become lowercase hyphenated names. Nextcloud Calendar becomes nextcloud-calendar. This convention is consistent across the entire collection, making icon URLs derivable by formula without browsing.

For command-line use, the README documents both curl and wget:

```bash
curl -O https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nextcloud.svg
```

```bash
wget https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nextcloud.svg
```

## Available Formats and Light and Dark Variants

Every icon in the collection is available in three formats: SVG (the original source), PNG at 512px height (auto-generated from SVG), and WEBP at 512px height (also auto-generated). PNG and WEBP exist for dashboard applications that do not render SVG inline or that require raster images.

Many icons have light and dark theme variants. The naming convention adds a suffix: -light for icons optimized for dark backgrounds, and -dark for icons optimized for light backgrounds. For example, github-light.svg and github-dark.svg are separate files. This matters for dashboards that support theme switching: a dashboard in dark mode should use the light variant of an icon (white or light-colored) for visibility.

The svg/, png/, and webp/ directories are present at the root of the repository alongside metadata.json and tree.json, which catalog the collection programmatically. The scripts/ directory handles the auto-generation of PNG and WEBP from SVG sources, which is why SVG is identified as the original source format.

The README notes that the collection also indexes externally hosted icons from Simple Icons, served through Simple Icons' colorable CDN. These appear on dashboardicons.com with separate source links and credit. The Simple Icons collection uses a CC0-1.0 license for the collection itself, though that license does not waive trademark restrictions on the brand marks.

## MCP Server for AI Assistant Integration

The README documents an MCP server that exposes the icon collection to AI assistants and MCP-compatible clients. This allows Cursor or other MCP clients to search the icon collection and retrieve CDN URLs programmatically.

The MCP documentation is in web/docs/MCP.md in the repository. The .cursor/ and .opencode/ directories present at the root suggest that the project itself uses AI-assisted development tooling in its workflow.

This integration path is primarily useful for dashboard configuration tools or AI-assisted setup workflows that need to look up icon URLs without manual browsing. A developer building a tool to auto-configure Homarr or Homepage from a service list could use the MCP server to resolve icon URLs for each service name.

## Submitting New Icons and the Review Process

The README documents two submission paths and is explicit about which is preferred. The recommended path is the submission form at dashboardicons.com. The README states that submissions through the website can be instantly received, processed, and approved by admins, and that this is the preferred method.

The alternative is a GitHub issue. The README uses a warning note to signal that GitHub issues may take significantly longer to review and process. Existing GitHub issue templates are preserved for this path, but the site form is consistently faster.

For contributors who want to help review, approve, or reject submissions, the README lists Discord (discord.com/invite/aCsmEV5RgA) and email (homarr-labs@proton.me) as contact points. Icon contributions require following the specifications in CONTRIBUTING.md, which defines size, color profile, and naming requirements.

The collection is community-driven in the sense that icons are submitted by contributors rather than produced by a dedicated design team. The tradeoff is that consistency depends on contributor adherence to the specification rather than a centralized design process.

## Limitations, Legal Notice, and Comparison with Simple Icons

Dashboard Icons is a curated service icon set focused on applications commonly used in self-hosted environments. It is not a general-purpose icon library for UI components, general-purpose web icons, or abstract symbols. A developer building a web application UI and looking for generic icons should look at a library like Heroicons or Lucide instead; Dashboard Icons covers service brands only.

The collection has 1800+ icons, which is comprehensive for popular services but limited for niche applications, internal tools, or regional services with low global adoption. When a needed icon is absent, the submission process through dashboardicons.com is the supported path, but review timelines are not documented.

The legal section of the README is direct: all product names, trademarks, and registered trademarks are property of their respective owners. Icons are used for identification purposes only. This means Dashboard Icons does not guarantee that any specific icon complies with a brand's trademark guidelines. Teams using these icons in commercial products should verify brand guidelines for services where trademark enforcement is active.

Simple Icons is the natural comparison: it is also a collection of SVG brand icons, CC0 licensed at the collection level, with a large catalog of tech brand marks. Dashboard Icons differs in that it focuses on services used in self-hosted dashboards and provides PNG and WEBP formats alongside SVG, as well as light and dark variants that Simple Icons does not offer as a built-in feature. Dashboard Icons also integrates directly with Homarr's own infrastructure and submission workflow.

## Conclusion

Dashboard Icons is the right tool when you want a single CDN-backed source for service icons in Homarr, Homepage, Dashy, or any other self-hosted dashboard. The naming convention is kebab-case and consistent, so icon URLs are predictable without browsing the repository. The main limitation is coverage: 1800+ icons is a large set, but niche services and internal tools will not be there. The preferred submission path is the dashboardicons.com form rather than a GitHub issue, and the README notes that GitHub issues process more slowly. The project is Apache-2.0 licensed, but the disclaimer section clarifies that product names and trademarks remain property of their respective owners and icons are used for identification only.

## FAQ

### What is Dashboard Icons and how do I use it in Homarr?

Dashboard Icons is a collection of over 1800 SVG, PNG, and WEBP icons for services and tools, available via jsDelivr CDN. In Homarr, reference an icon using the CDN URL pattern https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/<icon-name>.svg with the service name in kebab-case.

### How do I download a Dashboard Icons SVG file?

Use curl or wget with the CDN URL. The README gives this example: curl -O https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nextcloud.svg. Replace nextcloud with the kebab-case name of the service you need.

### What is a dashboard icon alternative to Dashboard Icons?

Simple Icons is the closest alternative: a large collection of SVG brand icons under a CC0 collection license. It covers a broader range of brands but does not provide light and dark theme variants, PNG or WEBP formats, or the self-hosted service focus that Dashboard Icons targets.

### Does Dashboard Icons have light and dark theme variants?

Yes. Many icons have -light and -dark suffixed variants. Use the -light suffix for icons displayed on dark backgrounds and the -dark suffix for icons on light backgrounds. For example, github-light.svg and github-dark.svg are separate files in the svg/ directory.

## Sources

- [homarr-labs/dashboard-icons on GitHub](https://github.com/homarr-labs/dashboard-icons)
- [Issues](https://github.com/homarr-labs/dashboard-icons/issues)
- [License: Apache-2.0](https://github.com/homarr-labs/dashboard-icons/blob/main/LICENSE)
- [Project website](https://dashboardicons.com)
- [README](https://github.com/homarr-labs/dashboard-icons/blob/main/README.md)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/homarr-labs-dashboard-icons
