docs: Update docs progress
This commit is contained in:
33
README-old.md
Normal file
33
README-old.md
Normal file
@@ -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``
|
||||||
86
README.md
86
README.md
@@ -1,33 +1,71 @@
|
|||||||
# MyHomePage, a home page for your home server
|
<p align = "center">
|
||||||
### Do not hesitate to star ⭐ this repo if you like the project ! 
|
<h3 align = "center"> Homarr <h3>
|
||||||
### 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.
|
<p align = "center">
|
||||||
|
A homepage for <i>your</i> server.
|
||||||
|
<br/>
|
||||||
|
<a href = "https://github.com/ajnart/homarr/deployments/activity_log?environment=Production" > <strong> Demo ↗️ </strong> </a> • <a href = "#install" > <strong> Install ➡️ </strong> </a>
|
||||||
|
</p>
|
||||||
|
</p>
|
||||||
|
|
||||||
## Install
|
# 📃 Table of Contents
|
||||||
### Docker installation
|
- [📃 Table of Contents](#-table-of-contents)
|
||||||
Required : Docker
|
- [🚀 Getting Started](#-getting-started)
|
||||||
#### Standard docker install
|
- [ℹ️ About](#ℹ️-about)
|
||||||
To install the MyHomePage docker image simply execute ``docker pull ghcr.io/ajnart/mhp``
|
- [⚡ Installation](#-installation)
|
||||||
To run the docker file ``docker run --name my-home-page -p 7575:80 -d ghcr.io/ajnart/mhp``
|
- [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*
|
<!-- Getting Started -->
|
||||||
#### Docker compose
|
# 🚀 Getting Started
|
||||||
Here's a docker compose example on how to integrate MHP into your container stack
|
|
||||||
```docker
|
## ℹ️ 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:
|
services:
|
||||||
mhp:
|
mhp:
|
||||||
|
container_name: homarr
|
||||||
image: ghcr.io/ajnart/mhp
|
image: ghcr.io/ajnart/mhp
|
||||||
|
restart: unless-stopped
|
||||||
ports:
|
ports:
|
||||||
- '7575:80'
|
- '7575:80'
|
||||||
restart: always
|
|
||||||
```
|
```
|
||||||
### Local installation
|
|
||||||
Required: Node (LTS)
|
### Building from Source 🛠️
|
||||||
#### Install using node
|
|
||||||
To install MyHomePage locally:
|
_Requirements_:
|
||||||
- Clone the source code or download it.
|
- [Git](https://git-scm.com/downloads)
|
||||||
- Execute ``npm install`` or ``yarn install`` *(prefered)* to install the dependencies
|
- [NodeJS](https://nodejs.org/en/) _(Latest or LTS)_
|
||||||
- Execute ``yarn export`` to build the source code into the final HTML pages in the ``./out`` folder
|
- [Yarn](https://yarnpkg.com/)
|
||||||
- Run a web server to serve the content of the ``./out`` folder. Example: ``python -m http.server 7575 --directory out``
|
- 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`
|
||||||
|
|||||||
Reference in New Issue
Block a user