homarr
Customizable browser's home page to interact with your homeserver's Docker containers (e.g. Sonarr/Radarr)
Top Related Projects
An Application dashboard and launcher
Flame is self-hosted startpage for your server. Easily manage your apps and bookmarks with built-in editors.
A very simple static homepage for your server.
HTPC/Homelab Services Organizer - Written in PHP
A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.
Quick Overview
Homarr is a sleek, modern dashboard designed to simplify the organization and access of your self-hosted services and bookmarks. It offers a customizable interface that allows users to create a personalized homepage for their server or homelab environment, integrating various services and providing quick access to frequently used resources.
Pros
- Highly customizable with a user-friendly interface
- Supports integration with various self-hosted services and applications
- Features a built-in search function for quick access to services and bookmarks
- Responsive design that works well on both desktop and mobile devices
Cons
- Requires some technical knowledge to set up and configure
- Limited documentation for advanced features and customizations
- May have performance issues with a large number of services or on low-powered devices
- Some users report occasional bugs or stability issues
Getting Started
To get started with Homarr, follow these steps:
- Install Docker on your system if not already installed.
- Run the following command to pull and start the Homarr container:
docker run -d \
--name homarr \
-p 7575:7575 \
-v /path/to/config:/app/data/configs \
-v /path/to/icons:/app/public/icons \
--restart unless-stopped \
ghcr.io/ajnart/homarr:latest
- Access Homarr by navigating to
http://your-server-ip:7575
in your web browser. - Follow the on-screen instructions to set up your initial dashboard and add services.
For more detailed instructions and configuration options, refer to the official documentation on the GitHub repository.
Competitor Comparisons
An Application dashboard and launcher
Pros of Heimdall
- More established project with a larger user base and community support
- Offers a wider range of customization options for dashboard appearance
- Supports multiple users with different access levels
Cons of Heimdall
- Less frequent updates and slower development cycle
- More resource-intensive, especially for larger dashboards
- Limited integration capabilities compared to Homarr
Code Comparison
Heimdall (PHP):
public function index()
{
$apps = App::all();
return view('dash', compact('apps'));
}
Homarr (JavaScript):
export async function getServerSideProps() {
const apps = await getApps();
return { props: { apps } };
}
Both projects aim to provide a dashboard for self-hosted services, but they differ in their approach and implementation. Heimdall is built with PHP and Laravel, offering a more traditional web application structure. Homarr, on the other hand, is developed using Next.js and React, providing a modern, responsive interface.
Heimdall's code focuses on server-side rendering and database interactions, while Homarr leverages JavaScript and client-side rendering for a more dynamic user experience. Homarr also includes features like service monitoring and integration with external APIs, which are not present in Heimdall.
Overall, the choice between these two projects depends on specific requirements, such as desired features, performance needs, and development preferences.
Flame is self-hosted startpage for your server. Easily manage your apps and bookmarks with built-in editors.
Pros of Flame
- More customizable appearance with themes and custom CSS
- Supports multiple users with different permissions
- Includes a built-in weather widget
Cons of Flame
- Less active development and fewer recent updates
- Limited integration options compared to Homarr
- Lacks advanced features like system monitoring
Code Comparison
Flame (JavaScript):
const App = () => {
return (
<ThemeProvider theme={theme}>
<Router>
<Switch>
<Route exact path="/" component={Home} />
<Route path="/settings" component={Settings} />
</Switch>
</Router>
</ThemeProvider>
);
};
Homarr (TypeScript):
const App: React.FC = () => {
return (
<ConfigProvider>
<ThemeProvider>
<Layout>
<AppContent />
</Layout>
</ThemeProvider>
</ConfigProvider>
);
};
Both projects use React for their frontend, but Homarr utilizes TypeScript for improved type safety and developer experience. Flame's routing is more explicit, while Homarr uses a custom Layout component to handle page structure.
Homarr offers more extensive customization options and integrations, making it suitable for users who need advanced features and frequent updates. Flame, on the other hand, provides a simpler setup with built-in multi-user support and theming, which may be preferable for users seeking a more straightforward dashboard solution.
A very simple static homepage for your server.
Pros of Homer
- Simpler setup and configuration using YAML files
- Lightweight and faster to load, especially for users with slower connections
- More customizable themes and color schemes out of the box
Cons of Homer
- Less feature-rich compared to Homarr's advanced functionalities
- Limited integration capabilities with external services and APIs
- Lacks real-time updates and dynamic content without manual refresh
Code Comparison
Homer (YAML configuration):
services:
- name: "My Service"
logo: "assets/tools/sample.png"
url: "https://example.com"
target: "_blank"
Homarr (React component):
<Card
title="My Service"
icon={<img src="assets/tools/sample.png" alt="Service Icon" />}
url="https://example.com"
openInNewTab={true}
/>
Both Homer and Homarr are dashboard solutions for self-hosted services, but they cater to different user needs. Homer focuses on simplicity and ease of use, making it ideal for users who prefer a straightforward setup. Homarr, on the other hand, offers more advanced features and integrations, making it suitable for users who require a more dynamic and feature-rich dashboard experience. The choice between the two depends on the user's specific requirements and technical expertise.
HTPC/Homelab Services Organizer - Written in PHP
Pros of Organizr
- More mature project with a larger user base and community
- Offers user authentication and access control features
- Supports plugins for extended functionality
Cons of Organizr
- Heavier resource usage due to PHP backend
- Less modern UI design compared to Homarr
- Steeper learning curve for setup and configuration
Code Comparison
Organizr (PHP):
<?php
$config = new Config();
$organizrAuth = new OrganizrAuth($config);
$user = $organizrAuth->getUser();
if ($user->isAuthenticated()) {
// User is logged in
}
Homarr (JavaScript):
import { useUser } from '@/hooks/useUser';
const { user, isLoading } = useUser();
if (user && !isLoading) {
// User is logged in
}
Both Organizr and Homarr are self-hosted dashboard solutions for managing web services and applications. Organizr is a more established project with a larger feature set, including user management and access control. However, it may require more resources and have a steeper learning curve. Homarr, on the other hand, offers a more modern and lightweight approach with a focus on simplicity and ease of use. The code comparison shows the difference in authentication approaches, with Organizr using a PHP backend and Homarr leveraging React hooks for user management.
A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.
Pros of Homepage
- More customizable layout with grid-based design
- Supports a wider range of services and integrations
- Offers more detailed system monitoring features
Cons of Homepage
- Steeper learning curve due to more complex configuration
- Less user-friendly interface for beginners
- Requires more setup time compared to Homarr
Code Comparison
Homarr configuration (YAML):
services:
- name: Plex
icon: plex
url: http://plex.local:32400
- name: Sonarr
icon: sonarr
url: http://sonarr.local:8989
Homepage configuration (YAML):
services:
- name: Plex
icon: plex
href: http://plex.local:32400
widget:
type: plex
url: http://plex.local:32400
key: your-plex-api-key
- name: Sonarr
icon: sonarr
href: http://sonarr.local:8989
widget:
type: sonarr
url: http://sonarr.local:8989
key: your-sonarr-api-key
The code comparison shows that Homepage requires more detailed configuration, including widget types and API keys, while Homarr's setup is simpler but less feature-rich.
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Demo ⨠⢠Install ð» ⢠Translations ðº ⢠Discord ð
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.
- ðï¸ Highly customizable with an extensive drag and drop grid system
- ⨠Integrates seamlessly with your favorite self-hosted applications
- ð Easy and fast app management - no YAML involved
- ð Advanced secrets' management system for enhanced security
- ð Detailed documentation and active community
- ð Search through the web or supported integrations in an instant
- ð´ó §ó ¢ó ®ó ©ó ²ó ¿ Monitor your application with a built-in status system
- ð¦ Comprehensive built-in icon picker with over 7000 icons
- ð³ Easy deployment with Docker, unRAID, and Synology
- ð Compatible with any major consumer hardware (x86, Raspberry Pi, old laptops, ...)
Homarr has a built-in collection of widgets and integrations, that connect to your applications and enable you to control them directly from the dashboard. Each widget and integration has a comprehensive documentation Homarr will integrate with the following applications:
ð¥ Torrent clients
ð¥ Usenet clients
ðº Media servers
ð Media collection managers
ðï¸ Media request managers
ð« DNS ad-blockers
Other integrations
We're constantly adding new integrations and widgets, which will enhance your experience even further.
Since we are updating Homarr very frequently, we recommend reading our official installation guides:
Homarr is maintained by motivated developers in their free-time. We work for fun and learning on this project.
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.
You can also support us by helping with translating the entire project to as many language as possible or contributing directly to the code or documentation.
Please read our Contribution Guidelines
All contributions, regardless of their size or scope, are welcome and highly appreciated! Thank you â¤ï¸
Top Related Projects
An Application dashboard and launcher
Flame is self-hosted startpage for your server. Easily manage your apps and bookmarks with built-in editors.
A very simple static homepage for your server.
HTPC/Homelab Services Organizer - Written in PHP
A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations.
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot