From 15137cc889ed611a8e7109a878b57b00089970e4 Mon Sep 17 00:00:00 2001 From: Aj - Thomas <49837342+ajnart@users.noreply.github.com> Date: Sun, 8 May 2022 22:10:19 +0200 Subject: [PATCH] Update README.md --- README.md | 36 +++++++++++++++++++++++++++--------- 1 file changed, 27 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 3a71ae87d..50ce21285 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,31 @@ -# HomePage, a home page for your home server +# MyHomePage, a home page for your home server -## What is HomePage ? +## 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. -## How to use HomePage ? - -### 1. Install HomePage - -### 2. Configure HomePage - -### 3. Start HomePage +## Install +### Docker installation +Required : Docker +#### Standard docker install +To install the MyHomePage docker image simply execute ``docker pull ajnart/mhp`` +To run the docker file ``docker run --name my-home-page -p 7575:80 -d 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: 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``