Update README.md

This commit is contained in:
Aj - Thomas
2022-05-08 22:10:19 +02:00
committed by GitHub
parent c18edcc282
commit 15137cc889

View File

@@ -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``