aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorBastien Wirtz <bastien.wirtz@gmail.com>2020-06-23 22:56:33 -0700
committerBastien Wirtz <bastien.wirtz@gmail.com>2020-06-28 11:05:40 -0700
commitb102c9b2b3aaa4d66bda8d932ba2d6bd4575c044 (patch)
tree41bdb9b456cbb8d59aaf421e8c82582a4eabcc55 /README.md
parent796a16c8da1e40aef418559ade2252a5275708c8 (diff)
downloadhomer-b102c9b2b3aaa4d66bda8d932ba2d6bd4575c044.tar.gz
homer-b102c9b2b3aaa4d66bda8d932ba2d6bd4575c044.tar.zst
homer-b102c9b2b3aaa4d66bda8d932ba2d6bd4575c044.zip
Regroup all editable files in one place
Diffstat (limited to 'README.md')
-rw-r--r--README.md16
1 files changed, 5 insertions, 11 deletions
diff --git a/README.md b/README.md
index 65ef9ab..7d76b0e 100644
--- a/README.md
+++ b/README.md
@@ -38,31 +38,25 @@ ervices on hand, from a simple `yaml` configuration file.
38 38
39Homer 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**. 39Homer 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**.
40 40
41For more information about the `config.yml` file see [configuration](docs/configuration.md) the section. 41See [documentation](docs/configuration.md) for information about the configuration (`assets/config.yml`) options.
42 42
43### Using docker 43### Using docker
44 44
45```sh 45```sh
46docker run -p 8080:8080 -v /your/local/config.yml:/www/config.yml -v /your/local/assets/:/www/assets b4bz/homer:latest 46docker run -p 8080:8080 -v /your/local/assets/:/www/assets b4bz/homer:latest
47``` 47```
48 48
49As a bind mount is used here, docker will not copy the initial content of the `assets` directory to the mounted directory. 49Default 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" [...]`).
50You can initialise your assets directory with the content provided in this repository
51```sh
52cp -r /public/assets/* /your/local/assets/
53```
54
55**Alternatively** if you just want to provide images/icons without customizing the other files (app manifest & pwa icons), you can mount a custom directory in the `www` directory and use it in your `config.yml` for icons path.
56 50
57### Using the release tarball (prebuilt, ready to use) 51### Using the release tarball (prebuilt, ready to use)
58 52
59Download and extract the latest the latest release (`homer.zip`) from the [release page](https://github.com/bastienwirtz/homer/releases), rename the `config.yml.dist` file to `config.yml`, and put it behind a webserver. 53Download 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.
60 54
61```sh 55```sh
62wget https://github.com/bastienwirtz/homer/releases/latest/download/homer.zip 56wget https://github.com/bastienwirtz/homer/releases/latest/download/homer.zip
63unzip homer.zip 57unzip homer.zip
64cd homer 58cd homer
65cp config.yml.dist config.yml 59cp assets/config.yml.dist assets/config.yml
66npx serve # or python -m http.server 8010 or apache, nginx ... 60npx serve # or python -m http.server 8010 or apache, nginx ...
67``` 61```
68 62