aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorBastien Wirtz <bastien.wirtz@gmail.com>2022-04-30 15:42:31 +0200
committerGitHub <noreply@github.com>2022-04-30 15:42:31 +0200
commit7e48e099aa968307d2b99720a076b4bdc706b5fd (patch)
tree971b362eb335628d818a3faf14ba4a6d9749d850 /README.md
parentaf0a6e89c9104ed69766e41f032a4b610ef67ccd (diff)
parent4f56c2c11baad8f98c338989fb0cd8e5af78d0c8 (diff)
downloadhomer-7e48e099aa968307d2b99720a076b4bdc706b5fd.tar.gz
homer-7e48e099aa968307d2b99720a076b4bdc706b5fd.tar.zst
homer-7e48e099aa968307d2b99720a076b4bdc706b5fd.zip
Merge pull request #421 from bastienwirtz/docker-rework
Docker rework
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 11 insertions, 14 deletions
diff --git a/README.md b/README.md
index 5ea80fb..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,12 +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.
86
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`).
89
85 90
86### Using docker-compose 91### Using docker-compose
87 92
88The `docker-compose.yml` file must be edited to match your needs. 93The `docker-compose.yml` file must be edited to match your needs.
89Set 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):
90 95
91```yaml 96```yaml
92volumes: 97volumes:
@@ -95,21 +100,13 @@ ports:
95 - 8080:8080 100 - 8080:8080
96``` 101```
97 102
98To launch container: 103Then launch the container:
99 104
100```sh 105```sh
101cd /path/to/docker-compose.yml 106cd /path/to/docker-compose.yml/
102docker-compose up -d 107docker-compose up -d
103``` 108```
104 109
105Default 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`:
106
107```yaml
108environment:
109 - UID=1000
110 - GID=1000
111```
112
113### Using the release tarball (prebuilt, ready to use) 110### Using the release tarball (prebuilt, ready to use)
114 111
115Download 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.