2022-05-11 15:10:05 +02:00
<p align = "center">
<h3 align = "center"> Homarr <h3>
<p align = "center">
A homepage for <i>your</i> server.
<br/>
2022-05-13 10:37:36 +02:00
<a href = "https://github.com/ajnart/homarr/deployments/activity_log?environment=Production" > <strong> Demo ↗️ </strong> </a> • <a href = "#-installation" > <strong> Install ➡️ </strong> </a>
2022-05-12 13:07:47 +02:00
<br />
<br />
2022-05-13 13:03:33 +02:00
<i>Join the discord!</i>
<br />
<a href = "https://discord.gg/aCsmEV5RgA" > <img src="https://discordapp.com/api/guilds/972958686051962910/widget.png?style=shield" > </a>
2022-05-11 15:10:05 +02:00
</p>
</p>
# 📃 Table of Contents
- [📃 Table of Contents ](#-table-of-contents )
- [🚀 Getting Started ](#-getting-started )
- [ℹ ️ About ](#ℹ ️ -about )
- [⚡ Installation ](#-installation )
- [Deploying from Docker Image 🐳 ](#deploying-from-docker-image- )
- [Building from Source 🛠️ ](#building-from-source-️ )
2022-05-12 13:07:47 +02:00
- [💖 Contributing ](#-contributing )
2022-05-11 15:10:05 +02:00
<!-- Getting Started -->
# 🚀 Getting Started
## ℹ ️ About
Homarr is a simple and lightweight homepage for your server, that helps you easily access all of your services in one place.
2022-05-12 14:10:40 +02:00
**[⤴️ Back to Top ](#-table-of-contents )**
2022-05-11 15:10:05 +02:00
## ⚡ Installation
### Deploying from Docker Image 🐳
> Supported architectures: x86-64, ARM, ARM64
_Requirements_:
- [Docker ](https://docs.docker.com/get-docker/ )
**Standard Docker Install**
```sh
2022-05-13 04:10:09 +02:00
docker run --name homarr -p 7575:7575 -d ghcr.io/ajnart/homarr
2022-05-11 15:10:05 +02:00
```
**Docker Compose**
```yml
---
version: '3'
#--------------------------------------------------------------------------------------------#
# Homarr - A homepage for your server. #
#--------------------------------------------------------------------------------------------#
2022-05-08 22:10:19 +02:00
services:
2022-05-12 14:24:15 +02:00
homarr:
2022-05-11 15:10:05 +02:00
container_name: homarr
2022-05-12 14:24:15 +02:00
image: ghcr.io/ajnart/homarr
2022-05-11 15:10:05 +02:00
restart: unless-stopped
2022-05-08 22:10:19 +02:00
ports:
2022-05-13 04:10:09 +02:00
- '7575:7575'
2022-05-08 22:10:19 +02:00
```
2022-05-11 15:10:05 +02:00
### Building from Source 🛠️
_Requirements_:
- [Git ](https://git-scm.com/downloads )
- [NodeJS ](https://nodejs.org/en/ ) _ (Latest or LTS) _
- [Yarn ](https://yarnpkg.com/ )
**Installing**
2022-05-12 13:07:47 +02:00
- Clone the GitHub repo: `git clone https://github.com/ajnart/homarr.git` & `cd homarr`
2022-05-11 15:10:05 +02:00
- Install all dependencies: `yarn install`
2022-05-13 10:37:36 +02:00
- Build the source: `yarn build`
- Start the NextJS web server: ``yarn start` `
2022-05-13 13:06:13 +02:00
- *Note: If you want to update the code in real time, launch with ``yarn dev` `*
2022-05-12 13:07:47 +02:00
# 💖 Contributing
2022-05-12 14:36:04 +02:00
You can contribute by [Starting a discussion ](https://github.com/ajnart/homarr/discussions ), [Submitting Bugs ](https://github.com/ajnart/homarr/issues/new ), [Requesting Features ](https://github.com/ajnart/homarr/issues/new ), or [Making a pull request ](https://github.com/ajnart/homarr/compare )!
2022-05-12 13:50:14 +02:00
All contributions are highly appreciated.
2022-05-12 14:10:40 +02:00
**[⤴️ Back to Top ](#-table-of-contents )**