X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=5a08483aa48840a962bf50a0925e7a10db87964c;hb=refs%2Fpull%2F475%2Fhead;hp=2dd2b42b50dd6bba697c50b7404ec55b01a4d176;hpb=7129af3bda3a7a7d506bd8c8f122ad8995c2906c;p=github%2Fbastienwirtz%2Fhomer.git diff --git a/README.md b/README.md index 2dd2b42..5a08483 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ - Search - Grouping - Theme customization -- Offline heath check +- Offline health check - keyboard shortcuts: - `/` Start searching. - `Escape` Stop searching. @@ -71,8 +71,6 @@ See [documentation](docs/configuration.md) for information about the configurati ### Using docker -To launch container: - ```sh docker run -d \ -p 8080:8080 \ @@ -81,12 +79,19 @@ docker run -d \ 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" [...]`). +Environment variables: + +* **`INIT_ASSETS`** (default: `1`) +Install example configuration file & assets (favicons, ...) to help you get started. + +* **`SUBFOLDER`** (default: `null`) +If you would like to host Homer in a subfolder, (ex: *http://my-domain/**homer***), set this to the subfolder path (ex `/homer`). + ### 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): +You probably want to set the port mapping and volume binding (equivalent to `-p` and `-v` arguments): ```yaml volumes: @@ -95,21 +100,13 @@ ports: - 8080:8080 ``` -To launch container: +Then launch the container: ```sh -cd /path/to/docker-compose.yml +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 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 web server.