diff options
-rw-r--r-- | README.md | 29 | ||||
-rw-r--r-- | docker-compose.yml | 14 |
2 files changed, 43 insertions, 0 deletions
@@ -70,12 +70,41 @@ See [documentation](docs/configuration.md) for information about the configurati | |||
70 | 70 | ||
71 | ### Using docker | 71 | ### Using docker |
72 | 72 | ||
73 | To launch container : | ||
74 | |||
73 | ```sh | 75 | ```sh |
74 | docker run -p 8080:8080 -v /your/local/assets/:/www/assets b4bz/homer:latest | 76 | docker run -p 8080:8080 -v /your/local/assets/:/www/assets b4bz/homer:latest |
75 | ``` | 77 | ``` |
76 | 78 | ||
77 | 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" [...]`). | 79 | 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" [...]`). |
78 | 80 | ||
81 | ### Using docker-compose | ||
82 | |||
83 | The `docker-compose.yml` file must be edited to match your needs. | ||
84 | Set the port and volume (equivalent to -p and -v arguments) : | ||
85 | |||
86 | ```yaml | ||
87 | volumes: | ||
88 | - /your/local/assets/:/www/assets | ||
89 | ports: | ||
90 | - 8080:8080 | ||
91 | ``` | ||
92 | |||
93 | To launch container : | ||
94 | |||
95 | ```sh | ||
96 | cd /path/to/docker-compose.yml | ||
97 | docker-compose up -d | ||
98 | ``` | ||
99 | |||
100 | 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` : | ||
101 | |||
102 | ```yaml | ||
103 | environment: | ||
104 | - UID=1000 | ||
105 | - GID=1000 | ||
106 | ``` | ||
107 | |||
79 | ### Using the release tarball (prebuilt, ready to use) | 108 | ### Using the release tarball (prebuilt, ready to use) |
80 | 109 | ||
81 | 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. | 110 | 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. |
diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..85e9156 --- /dev/null +++ b/docker-compose.yml | |||
@@ -0,0 +1,14 @@ | |||
1 | --- | ||
2 | version: "2" | ||
3 | services: | ||
4 | homer: | ||
5 | image: b4bz/homer | ||
6 | container_name: homer | ||
7 | volumes: | ||
8 | - /your/local/assets/:/www/assets | ||
9 | ports: | ||
10 | - 8080:8080 | ||
11 | #environment: | ||
12 | # - UID=1000 | ||
13 | # - GID=1000 | ||
14 | restart: unless-stopped | ||