aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorBastien Wirtz <bastien.wirtz@gmail.com>2022-04-10 11:55:11 +0200
committerBastien Wirtz <bastien.wirtz@gmail.com>2022-04-30 15:39:36 +0200
commit049f85221e945b90bf87d21afe4d306839d65740 (patch)
tree1288ab580f2a274df8b507e2bbe37e2ff03c70ca /README.md
parentcd75da69f9e57c3fe0f63c3ed6def0577d75a47c (diff)
downloadhomer-049f85221e945b90bf87d21afe4d306839d65740.tar.gz
homer-049f85221e945b90bf87d21afe4d306839d65740.tar.zst
homer-049f85221e945b90bf87d21afe4d306839d65740.zip
Simplify the container starting process to allow it to run with a
unprivileged user
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 9 insertions, 16 deletions
diff --git a/README.md b/README.md
index 57185a7..6ac71e6 100644
--- a/README.md
+++ b/README.md
@@ -71,8 +71,6 @@ See [documentation](docs/configuration.md) for information about the configurati
71 71
72### Using docker 72### Using docker
73 73
74To launch container:
75
76```sh 74```sh
77docker run -d \ 75docker run -d \
78 -p 8080:8080 \ 76 -p 8080:8080 \
@@ -81,16 +79,19 @@ docker run -d \
81 b4bz/homer:latest 79 b4bz/homer:latest
82``` 80```
83 81
84Default 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" [...]`). 82Environment variables:
83
84* **`INIT_ASSETS`** (default: `1`)
85Install exemple configuration file & assets (favicons, ...) to help you get started.
85 86
86## Host in subfolder 87* **`SUBFOLDER`** (default: `null`)
88If you would like to host Homer in a subfolder, (ex: *http://my-domain/**homer***), set this to the subfolder path (ex `/homer`).
87 89
88If you would like to host Homer in a subfolder, for e.g. behind a reverse proxy, supply the name of subfolder by using the `SUBFOLDER` env var.
89 90
90### Using docker-compose 91### Using docker-compose
91 92
92The `docker-compose.yml` file must be edited to match your needs. 93The `docker-compose.yml` file must be edited to match your needs.
93Set the port and volume (equivalent to `-p` and `-v` arguments): 94You probably want to set the port mapping and volume binding (equivalent to `-p` and `-v` arguments):
94 95
95```yaml 96```yaml
96volumes: 97volumes:
@@ -99,21 +100,13 @@ ports:
99 - 8080:8080 100 - 8080:8080
100``` 101```
101 102
102To launch container: 103Then launch the container:
103 104
104```sh 105```sh
105cd /path/to/docker-compose.yml 106cd /path/to/docker-compose.yml/
106docker-compose up -d 107docker-compose up -d
107``` 108```
108 109
109Default 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`:
110
111```yaml
112environment:
113 - UID=1000
114 - GID=1000
115```
116
117### Using the release tarball (prebuilt, ready to use) 110### Using the release tarball (prebuilt, ready to use)
118 111
119Download 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. 112Download 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.