Homarr

A homepage for your server.
Demo ↗️ • Install ➡️

Join the discord!

📃 Table of Contents

• 📃 Table of Contents
• 🚀 Getting Started
  • ℹ️ About
  • ⚡ Installation
    • Deploying from Docker Image 🐳
    • Building from Source 🛠️
• 💖 Contributing

🚀 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.

⤴️ Back to Top

⚡ Installation

Deploying from Docker Image 🐳

Supported architectures: x86-64, ARM, ARM64

Requirements:

• Docker

Standard Docker Install

docker run --name homarr -p 7575:7575 -d ghcr.io/ajnart/homarr

Docker Compose

---
version: '3'
#--------------------------------------------------------------------------------------------#
#                               Homarr -  A homepage for your server.                        #
#--------------------------------------------------------------------------------------------#
services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr
    restart: unless-stopped
    ports:
      - '7575:7575'

Building from Source 🛠️

Requirements:

• Git
• NodeJS (Latest or LTS)
• Yarn

Installing

• Clone the GitHub repo: git clone https://github.com/ajnart/homarr.git & cd homarr
• Install all dependencies: yarn install
• Build the source: yarn build
• Start the NextJS web server: yarn start
• Note: If you want to update the code in real time, launch with yarn dev

💖 Contributing

Please read our Contribution Guidelines

All contributions are highly appreciated.

⤴️ Back to Top