X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=945fa1f7192393e737126a5c534c6d44aa366f76;hb=c0044cc7653329044458fb233757b935893cd1a9;hp=33a15b19f1af8a23c98719b4bf03f38456fab254;hpb=8ae1fe8a4ecdf5dfd8cabb4dc19bbe24401acd25;p=github%2Fbastienwirtz%2Fhomer.git diff --git a/README.md b/README.md index 33a15b1..945fa1f 100644 --- a/README.md +++ b/README.md @@ -2,13 +2,13 @@ Homer's donut + src="https://raw.githubusercontent.com//bastienwirtz/homer/main/public/logo.png">
Homer

- A dead simple static HOMepage for your servER to keep your services on hand, from a simple `yaml` configuration file. + A dead simple static HOMepage for your servER to keep your services on hand, from a simple yaml configuration file.

@@ -36,7 +36,7 @@

- +

## Table of Contents @@ -44,15 +44,15 @@ - [Getting started](#getting-started) - [Configuration](docs/configuration.md) - [Tips & tricks](docs/tips-and-tricks.md) -- [Roadmap](#roadmap) -- [Developement](docs/developement.md) +- [Roadmap](#roadmap) +- [Development](docs/development.md) ## Features - [yaml](http://yaml.org/) file configuration - Installable (pwa) - Search -- Grouping +- Grouping - Theme customization - Offline heathcheck - keyboard shortcuts: @@ -70,16 +70,49 @@ See [documentation](docs/configuration.md) for information about the configurati ### Using docker +To launch container: + ```sh -docker run -p 8080:8080 -v /your/local/assets/:/www/assets b4bz/homer:latest +docker run -d \ + -p 8080:8080 \ + -v :/www/assets \ + --restart=always \ + b4bz/homer:latest ``` Default assets will be automatically installed in the `/www/assets` directory. Use `UID` and/or `GID` env var to change the assets owner (`docker run -e "UID=1000" -e "GID=1000" [...]`). +### Using docker-compose + +The `docker-compose.yml` file must be edited to match your needs. +Set the port and volume (equivalent to `-p` and `-v` arguments): + +```yaml +volumes: + - /your/local/assets/:/www/assets +ports: + - 8080:8080 +``` + +To launch container: + +```sh +cd /path/to/docker-compose.yml +docker-compose up -d +``` + +Default assets will be automatically installed in the `/www/assets` directory. Use `UID` and/or `GID` env var to change the assets owner, also in `docker-compose.yml`: + +```yaml +environment: + - UID=1000 + - GID=1000 +``` + ### Using the release tarball (prebuilt, ready to use) -Download and extract the latest the latest release (`homer.zip`) from the [release page](https://github.com/bastienwirtz/homer/releases), rename the `assets/config.yml.dist` file to `assets/config.yml`, and put it behind a webserver. - +Download and extract the latest release (`homer.zip`) from the [release page](https://github.com/bastienwirtz/homer/releases), rename the `assets/config.yml.dist` file to `assets/config.yml`, and put it behind a webserver. + ```sh wget https://github.com/bastienwirtz/homer/releases/latest/download/homer.zip unzip homer.zip