aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorBastien Wirtz <bastien.wirtz@gmail.com>2022-06-29 23:02:10 +0200
committerBastien Wirtz <bastien.wirtz@gmail.com>2022-06-29 23:02:10 +0200
commitb5bf977402c4bedd7c2ca771592635ac8dd07dca (patch)
tree14bb39c61f2066e9eb813197a82a2bcf75e231e4 /README.md
parenta01c40d4b34e1c4afea5b8e52f69e9a328b51d33 (diff)
downloadhomer-b5bf977402c4bedd7c2ca771592635ac8dd07dca.tar.gz
homer-b5bf977402c4bedd7c2ca771592635ac8dd07dca.tar.zst
homer-b5bf977402c4bedd7c2ca771592635ac8dd07dca.zip
Adding permissions configuration information.
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 7 insertions, 14 deletions
diff --git a/README.md b/README.md
index 5a08483..ea93f4f 100644
--- a/README.md
+++ b/README.md
@@ -65,9 +65,9 @@
65 65
66## Getting started 66## Getting started
67 67
68Homer is a full static html/js dashboard, generated from the source in `/src` using webpack. It's meant to be served by an HTTP server, **it will not work if you open dist/index.html directly over file:// protocol**. 68Homer is a full static html/js dashboard, based on a simple yaml configuration file. See [documentation](docs/configuration.md) for information about the configuration (`assets/config.yml`) options.
69 69
70See [documentation](docs/configuration.md) for information about the configuration (`assets/config.yml`) options. 70It's meant to be served by an HTTP server, **it will not work if you open the index.html directly over file:// protocol**.
71 71
72### Using docker 72### Using docker
73 73
@@ -79,7 +79,9 @@ docker run -d \
79 b4bz/homer:latest 79 b4bz/homer:latest
80``` 80```
81 81
82Environment variables: 82The container will run using a user uid and gid 1000. Add `--user <your-UID>:<your-GID>` to the docker command to adjust it. Make sure this match the ownership of your assets directory.
83
84**Environment variables:**
83 85
84* **`INIT_ASSETS`** (default: `1`) 86* **`INIT_ASSETS`** (default: `1`)
85Install example configuration file & assets (favicons, ...) to help you get started. 87Install example configuration file & assets (favicons, ...) to help you get started.
@@ -87,18 +89,9 @@ Install example configuration file & assets (favicons, ...) to help you get star
87* **`SUBFOLDER`** (default: `null`) 89* **`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`). 90If you would like to host Homer in a subfolder, (ex: *http://my-domain/**homer***), set this to the subfolder path (ex `/homer`).
89 91
92#### With docker-compose
90 93
91### Using docker-compose 94A [`docker-compose.yml`](docker-compose.yml) file is available as an example. It must be edited to match your needs. You probably want to adjust the port mapping and volume binding (equivalent to `-p` and `-v` arguments).
92
93The `docker-compose.yml` file must be edited to match your needs.
94You probably want to set the port mapping and volume binding (equivalent to `-p` and `-v` arguments):
95
96```yaml
97volumes:
98 - /your/local/assets/:/www/assets
99ports:
100 - 8080:8080
101```
102 95
103Then launch the container: 96Then launch the container:
104 97