Files
Homarr/README.md

125 lines
5.2 KiB
Markdown
Raw Normal View History

2022-05-24 21:26:10 +02:00
<!-- Project Title -->
2023-04-10 23:05:01 +02:00
![Banner](docs/banner.png)
<!-- Badges -->
2022-05-24 21:26:10 +02:00
<p align="center">
<img src="https://img.shields.io/github/stars/ajnart/homarr?label=%E2%AD%90%20Stars&style=flat-square?branch=master&kill_cache=1%22">
<a href="https://github.com/ajnart/homarr/releases/latest">
2023-04-10 23:05:01 +02:00
  <img alt="Latest Release (Semver)" src="https://img.shields.io/github/v/release/ajnart/homarr?label=%F0%9F%9A%80%20Release">
</a>
<a href="https://github.com/ajnart/homarr/actions/workflows/docker.yml">
2023-04-10 23:05:01 +02:00
  <img title="Docker CI Status" src="https://github.com/ajnart/homarr/actions/workflows/docker.yml/badge.svg" alt="CI Status">
</a>
<a href=https://crowdin.com/project/homarr>
<img title="Translations" src="https://badges.crowdin.net/homarr/localized.svg" />
</a>
<a href="https://discord.gg/aCsmEV5RgA">
2023-04-10 23:05:01 +02:00
  <img title="Discord" src="https://discordapp.com/api/guilds/972958686051962910/widget.png?style=shield">
</a>
2022-05-24 21:26:10 +02:00
</p>
<!-- Links -->
2022-05-24 21:26:10 +02:00
<p align="center">
2023-02-06 22:59:15 +01:00
<a href="https://demo.homarr.dev/">
<strong>Demo ✨</strong>
</a>
<a href="https://homarr.dev/docs/introduction/installation">
<strong>Install 💻</strong>
</a> •
<a href="https://crowdin.com/project/homarr">
<strong>Translations 🈺</strong>
</a> •
<a href="https://discord.com/invite/aCsmEV5RgA">
<strong>Discord 👋</strong>
</a>
2022-05-24 21:26:10 +02:00
</p>
2023-02-06 22:59:15 +01:00
Simplify the management of your server with Homarr - a sleek, modern dashboard that puts all of your apps and services at your fingertips. With Homarr, you can access and control everything in one convenient location. Homarr seamlessly integrates with the apps you've added, providing you with valuable information and giving you complete control. Installation is a breeze, and Homarr supports a wide range of deployment methods.
2023-02-06 22:59:15 +01:00
<br/>
<br/>
2023-04-10 23:05:01 +02:00
![Features Section](docs/section-features.png)
2023-02-11 13:32:26 +01:00
2023-04-10 23:05:01 +02:00
- 🖌️ Highly customizable with an extensive drag and drop grid system
2023-02-06 22:59:15 +01:00
- ✨ Integrates seamlessly with your favorite self-hosted applications
2023-04-10 23:05:01 +02:00
- 📌 Easy and fast app management - no YAML involved
- 🙊 Advanced secrets' management system for enhanced security
2023-02-06 22:59:15 +01:00
- 📄 Detailed documentation and active community
2023-04-10 23:05:01 +02:00
- 🔍 Search through the web or supported integrations in an instant
- 🏴󠁧󠁢󠁮󠁩󠁲󠁿 Monitor your application with a built-in status system
2023-02-06 22:59:15 +01:00
- 🦞 Comprehensive built-in icon picker with over 1000 icons
2023-04-10 23:05:01 +02:00
- 🐳 Easy deployment with Docker, unRAID, Synology
- 🚀 Compatible with any major consumer hardware (x86, Raspberry Pi, ...)
2023-02-06 22:59:15 +01:00
- 💵 Free and Open-Source - your data stays on your device
2022-05-13 17:29:03 +02:00
2023-02-06 22:59:15 +01:00
<br/>
<br/>
2023-04-10 23:05:01 +02:00
![Widgets & Integrations Section](docs/section-widgets-and-integrations.png)
2023-02-11 23:56:55 +09:00
2023-04-10 23:05:01 +02:00
Homarr has a [built-in collection of widgets and integrations](https://homarr.dev/docs/integrations/), that connect to your applications and enable you to control them directly from the dashboard.
Each widget and integration has a comprehensive documentation for your comfort.
2023-02-06 22:59:15 +01:00
Homarr will integrate with the following applications of yours:
2022-05-11 15:10:05 +02:00
2023-02-06 22:59:15 +01:00
- 📥 Torrent clients
2023-04-10 23:05:01 +02:00
- [Deluge](https://homarr.dev/docs/integrations/#deluge)
2023-02-06 22:59:15 +01:00
- [Transmission](https://homarr.dev/docs/integrations/#transmission)
2023-04-10 23:05:01 +02:00
- [qBittorent](https://homarr.dev/docs/integrations/#qbittorrent-integration)
2023-02-06 22:59:15 +01:00
- 📥 Usenet clients
- [SABnzbd](https://homarr.dev/docs/integrations/#sabnzbd)
- [NZBGet](https://homarr.dev/docs/integrations/#nzbget)
- 📚 Media collection managers
- [Sonarr](https://homarr.dev/docs/integrations/#sonarr)
- [Radarr](https://homarr.dev/docs/integrations/#radarr)
- [Lidarr](https://homarr.dev/docs/integrations/#lidarr)
- [Readarr](https://homarr.dev/docs/integrations/#readarr)
- 🎞️ Media request managers
- [Overseerr](https://homarr.dev/docs/integrations/#overseerr--jellyseerr)
- [Jellyseerr](https://homarr.dev/docs/integrations/#overseerr--jellyseerr)
- 🔌 [Dash.](https://homarr.dev/docs/integrations/#dash)
- 🐳 [Docker](https://homarr.dev/docs/integrations/#docker)
2022-05-16 01:30:35 +02:00
2023-02-06 22:59:15 +01:00
We're constantly adding new integrations and widgets, which will enhance your experience even further.
2022-05-11 15:10:05 +02:00
2023-02-06 22:59:15 +01:00
<br/>
<br/>
2022-05-11 15:10:05 +02:00
2023-04-10 23:05:01 +02:00
![Preview Section](docs/section-preview.png)
2022-05-11 15:10:05 +02:00
2023-02-06 23:10:05 +01:00
https://user-images.githubusercontent.com/30572287/217098893-5880e7de-13d0-42c5-b505-f7921593396f.mp4
2023-02-06 22:59:15 +01:00
<br/>
<br/>
2023-04-10 23:05:01 +02:00
![Installation Section](docs/section-installation.png)
2023-02-06 22:59:15 +01:00
There are many different ways, how Homarr can be installed.
2023-04-10 23:05:01 +02:00
Since we are developing Homarr very frequently, we recommend reading our official installation guides:
2023-02-06 22:59:15 +01:00
<a href="https://homarr.dev/docs/introduction/installation">
<img src="docs/installation-button.png" width="200" />
</a>
2022-05-11 15:10:05 +02:00
2023-02-06 22:59:15 +01:00
<br/>
<br/>
2022-05-11 15:10:05 +02:00
2023-04-10 23:05:01 +02:00
![Contribute Section](docs/section-contribute.png)
2023-02-06 22:59:15 +01:00
Homarr is maintained by motivated developers in their free-time.
We work for fun and learning on this project.
2022-05-11 15:10:05 +02:00
2023-04-10 23:05:01 +02:00
Hence, we're glad for all the help and support we can get.
Although a donation is appreciated, there are other ways you can support us.
2022-05-12 13:07:47 +02:00
2023-04-10 23:05:01 +02:00
<a href="https://ko-fi.com/ajnart">
<img src="https://cdn.ko-fi.com/cdn/kofi3.png?v=3" width="200" />
</a>
2022-05-16 01:30:35 +02:00
2023-04-10 23:05:01 +02:00
You can also support us [translating the entire project in as many languages as possible,](https://homarr.dev/docs/community/translations) or contribute directly to the code or documentation.
2022-05-16 01:30:35 +02:00
**Please read our [Contribution Guidelines](/CONTRIBUTING.md)**
2022-05-16 01:30:35 +02:00
2023-04-10 23:05:01 +02:00
All contributions, regardless of their size or scope, are welcome and highly appreciated! Thank you ❤️