X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=945fa1f7192393e737126a5c534c6d44aa366f76;hb=4a1e8717e90d1b0b516da2cbc1d16ff906d7fbdf;hp=d35f743d1f0c980830cb3265cb94e2b03e0f0568;hpb=2662b1704930eff56a61194a6796d463df687889;p=github%2Fbastienwirtz%2Fhomer.git diff --git a/README.md b/README.md index d35f743..945fa1f 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@

- 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.

@@ -44,7 +44,7 @@ - [Getting started](#getting-started) - [Configuration](docs/configuration.md) - [Tips & tricks](docs/tips-and-tricks.md) -- [Roadmap](#roadmap) +- [Roadmap](#roadmap) - [Development](docs/development.md) @@ -52,7 +52,7 @@ - [yaml](http://yaml.org/) file configuration - Installable (pwa) - Search -- Grouping +- Grouping - Theme customization - Offline heathcheck - keyboard shortcuts: @@ -70,10 +70,14 @@ See [documentation](docs/configuration.md) for information about the configurati ### Using docker -To launch container : +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" [...]`). @@ -81,7 +85,7 @@ Default assets will be automatically installed in the `/www/assets` directory. U ### 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) : +Set the port and volume (equivalent to `-p` and `-v` arguments): ```yaml volumes: @@ -90,25 +94,25 @@ ports: - 8080:8080 ``` -To launch container : +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` : +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 + - 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