diff --git a/README-old.md b/README-old.md
new file mode 100644
index 000000000..9e6b45ce6
--- /dev/null
+++ b/README-old.md
@@ -0,0 +1,33 @@
+# MyHomePage, a home page for your home server
+### Do not hesitate to star ⭐ this repo if you like the project ! 
+### Join the discord ! : https://discord.gg/C2WTXkzkwK
+## What is MyHomePage ?
+
+HomePage is a web page for your home server, it provides a user friendly interface to access docker containers or other services.
+
+## Install
+### Docker installation
+Required : Docker
+#### Standard docker install
+To install the MyHomePage docker image simply execute ``docker pull ghcr.io/ajnart/mhp``
+To run the docker file ``docker run --name my-home-page -p 7575:80 -d ghcr.io/ajnart/mhp``
+
+*Note: Currently the port used is 80 (Nginx default port) It will change to be 7575 by default*
+#### Docker compose
+Here's a docker compose example on how to integrate MHP into your container stack
+```docker
+services:
+ mhp:
+ image: ghcr.io/ajnart/mhp
+ ports:
+ - '7575:80'
+ restart: always
+```
+### Local installation
+Required: Node (LTS)
+#### Install using node
+To install MyHomePage locally:
+- Clone the source code or download it.
+- Execute ``npm install`` or ``yarn install`` *(prefered)* to install the dependencies
+- Execute ``yarn export`` to build the source code into the final HTML pages in the ``./out`` folder
+- Run a web server to serve the content of the ``./out`` folder. Example: ``python -m http.server 7575 --directory out``
diff --git a/README.md b/README.md
index 9e6b45ce6..127654014 100644
--- a/README.md
+++ b/README.md
@@ -1,33 +1,71 @@
-# MyHomePage, a home page for your home server
-### Do not hesitate to star ⭐ this repo if you like the project ! 
-### Join the discord ! : https://discord.gg/C2WTXkzkwK
-## What is MyHomePage ?
+
+
Homarr
-HomePage is a web page for your home server, it provides a user friendly interface to access docker containers or other services.
+
+ A homepage for your server.
+
+ Demo ↗️ • Install ➡️
+
+
-## Install
-### Docker installation
-Required : Docker
-#### Standard docker install
-To install the MyHomePage docker image simply execute ``docker pull ghcr.io/ajnart/mhp``
-To run the docker file ``docker run --name my-home-page -p 7575:80 -d ghcr.io/ajnart/mhp``
+# 📃 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-️)
-*Note: Currently the port used is 80 (Nginx default port) It will change to be 7575 by default*
-#### Docker compose
-Here's a docker compose example on how to integrate MHP into your container stack
-```docker
+
+# 🚀 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.
+
+## ⚡ Installation
+
+### Deploying from Docker Image 🐳
+> Supported architectures: x86-64, ARM, ARM64
+
+_Requirements_:
+- [Docker](https://docs.docker.com/get-docker/)
+
+**Standard Docker Install**
+```sh
+docker run --name homarr -p 7575:80 -d ghcr.io/ajnart/mhp
+```
+
+**Docker Compose**
+```yml
+---
+version: '3'
+#--------------------------------------------------------------------------------------------#
+# Homarr - A homepage for your server. #
+#--------------------------------------------------------------------------------------------#
services:
mhp:
+ container_name: homarr
image: ghcr.io/ajnart/mhp
+ restart: unless-stopped
ports:
- '7575:80'
- restart: always
```
-### Local installation
-Required: Node (LTS)
-#### Install using node
-To install MyHomePage locally:
-- Clone the source code or download it.
-- Execute ``npm install`` or ``yarn install`` *(prefered)* to install the dependencies
-- Execute ``yarn export`` to build the source code into the final HTML pages in the ``./out`` folder
-- Run a web server to serve the content of the ``./out`` folder. Example: ``python -m http.server 7575 --directory out``
+
+### Building from Source 🛠️
+
+_Requirements_:
+- [Git](https://git-scm.com/downloads)
+- [NodeJS](https://nodejs.org/en/) _(Latest or LTS)_
+- [Yarn](https://yarnpkg.com/)
+- Some web server
+
+**Installing**
+
+- Clone the GitHub repo: `git clone https://github.com/ajnart/homarr.git` & `cd myhomepage`
+- Install all dependencies: `yarn install`
+- Build the source: `yarn export`
+- Start a web server (Any web server will work):
+ - _Examples:_
+ - NodeJS serve: `npm i -g serve` or `yarn global add serve` & `serve ./out`
+ - python http.server: `python -m http.server 7474 --directory out`