2022-05-08 22:10:19 +02:00
|
|
|
# MyHomePage, a home page for your home server
|
2022-05-08 22:53:39 +02:00
|
|
|
Join the discord ! : https://discord.gg/C2WTXkzkwK
|
2022-05-08 22:10:19 +02:00
|
|
|
## What is MyHomePage ?
|
2022-05-01 14:45:56 +02:00
|
|
|
|
2022-04-25 00:11:32 +02:00
|
|
|
HomePage is a web page for your home server, it provides a user friendly interface to access docker containers or other services.
|
2022-05-01 14:45:56 +02:00
|
|
|
|
2022-05-08 22:10:19 +02:00
|
|
|
## Install
|
|
|
|
|
### Docker installation
|
|
|
|
|
Required : Docker
|
|
|
|
|
#### Standard docker install
|
2022-05-09 23:27:30 +02:00
|
|
|
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``
|
2022-05-09 02:00:32 +02:00
|
|
|
|
|
|
|
|
*Note: Currently the port used is 80 (Nginx default port) It will change to be 7575 by default*
|
2022-05-08 22:10:19 +02:00
|
|
|
#### 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``
|
