diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/configuration.md | 4 | ||||
-rw-r--r-- | docs/customservices.md | 60 | ||||
-rw-r--r-- | docs/tips-and-tricks.md | 2 | ||||
-rw-r--r-- | docs/troubleshooting.md | 6 |
4 files changed, 55 insertions, 17 deletions
diff --git a/docs/configuration.md b/docs/configuration.md index 65fd018..2083be3 100644 --- a/docs/configuration.md +++ b/docs/configuration.md | |||
@@ -19,6 +19,9 @@ logo: "assets/logo.png" | |||
19 | # icon: "fas fa-skull-crossbones" | 19 | # icon: "fas fa-skull-crossbones" |
20 | 20 | ||
21 | header: true # Set to false to hide the header | 21 | header: true # Set to false to hide the header |
22 | # Optional: Different hotkey for search, defaults to "/" | ||
23 | # hotkey: | ||
24 | # search: "Shift" | ||
22 | footer: '<p>Created with <span class="has-text-danger">❤️</span> with <a href="https://bulma.io/">bulma</a>, <a href="https://vuejs.org/">vuejs</a> & <a href="https://fontawesome.com/">font awesome</a> // Fork me on <a href="https://github.com/bastienwirtz/homer"><i class="fab fa-github-alt"></i></a></p>' # set false if you want to hide it. | 25 | footer: '<p>Created with <span class="has-text-danger">❤️</span> with <a href="https://bulma.io/">bulma</a>, <a href="https://vuejs.org/">vuejs</a> & <a href="https://fontawesome.com/">font awesome</a> // Fork me on <a href="https://github.com/bastienwirtz/homer"><i class="fab fa-github-alt"></i></a></p>' # set false if you want to hide it. |
23 | 26 | ||
24 | columns: "3" # "auto" or number (must be a factor of 12: 1, 2, 3, 4, 6, 12) | 27 | columns: "3" # "auto" or number (must be a factor of 12: 1, 2, 3, 4, 6, 12) |
@@ -26,7 +29,6 @@ connectivityCheck: true # whether you want to display a message when the apps ar | |||
26 | 29 | ||
27 | # Optional: Proxy / hosting option | 30 | # Optional: Proxy / hosting option |
28 | proxy: | 31 | proxy: |
29 | # NOT All custom services implements this new option YET. Support will be extended very soon. | ||
30 | useCredentials: false # send cookies & authorization headers when fetching service specific data. Set to `true` if you use an authentication proxy. Can be overrided on service level. | 32 | useCredentials: false # send cookies & authorization headers when fetching service specific data. Set to `true` if you use an authentication proxy. Can be overrided on service level. |
31 | 33 | ||
32 | # Set the default layout and color scheme | 34 | # Set the default layout and color scheme |
diff --git a/docs/customservices.md b/docs/customservices.md index 7a151d1..cb68e1d 100644 --- a/docs/customservices.md +++ b/docs/customservices.md | |||
@@ -1,7 +1,11 @@ | |||
1 | # Custom Services | 1 | # Custom Services |
2 | 2 | ||
3 | Some service can use a specific a component that provides some extra features by adding a `type` key to the service yaml | 3 | Some service can use a specific a component that provides some extra features by adding a `type` key to the service yaml |
4 | configuration. Available services are in `src/components/`. Here is an overview of all custom services that are available | 4 | configuration and, where applicable, an apikey. Note that config.yml is exposed at /assets/config.yml via HTTP and any |
5 | apikey included in the configuration file is exposed to anyone who can access the homer instance. Only include an apikey | ||
6 | if your homer instance is secured behind some form of authentication or access restriction. | ||
7 | |||
8 | Available services are in `src/components/`. Here is an overview of all custom services that are available | ||
5 | within Homer. | 9 | within Homer. |
6 | 10 | ||
7 | If you experiencing any issue, please have a look to the [troubleshooting](troubleshooting.md) page. | 11 | If you experiencing any issue, please have a look to the [troubleshooting](troubleshooting.md) page. |
@@ -18,8 +22,6 @@ If you experiencing any issue, please have a look to the [troubleshooting](troub | |||
18 | type: "<type>" | 22 | type: "<type>" |
19 | ``` | 23 | ``` |
20 | 24 | ||
21 | ⚠️🚧 `endpoint` & `useCredentials` new options are not yet supported by all custom services (but will be very soon). | ||
22 | |||
23 | ## PiHole | 25 | ## PiHole |
24 | 26 | ||
25 | Using the PiHole service you can display info about your local PiHole instance right on your Homer dashboard. | 27 | Using the PiHole service you can display info about your local PiHole instance right on your Homer dashboard. |
@@ -43,7 +45,7 @@ The following configuration is available for the OpenWeatherMap service: | |||
43 | - name: "Weather" | 45 | - name: "Weather" |
44 | location: "Amsterdam" # your location. | 46 | location: "Amsterdam" # your location. |
45 | locationId: "2759794" # Optional: Specify OpenWeatherMap city ID for better accuracy | 47 | locationId: "2759794" # Optional: Specify OpenWeatherMap city ID for better accuracy |
46 | apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. | 48 | apikey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. |
47 | units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. | 49 | units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. |
48 | background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. | 50 | background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. |
49 | type: "OpenWeather" | 51 | type: "OpenWeather" |
@@ -65,22 +67,39 @@ Two lines are needed in the config.yml : | |||
65 | The url must be the root url of Medusa application. | 67 | The url must be the root url of Medusa application. |
66 | The Medusa API key can be found in General configuration > Interface. It is needed to access Medusa API. | 68 | The Medusa API key can be found in General configuration > Interface. It is needed to access Medusa API. |
67 | 69 | ||
68 | ## Sonarr/Radarr | 70 | ## Lidarr, Prowlarr, Sonarr and Radarr |
69 | 71 | ||
70 | This service displays Activity (blue), Warning (orange) or Error (red) notifications bubbles from the Radarr/Sonarr application. | 72 | This service displays Activity (blue), Warning (orange) or Error (red) notifications bubbles from the Lidarr, Radarr or Sonarr application. |
71 | Two lines are needed in the config.yml : | 73 | Two lines are needed in the config.yml : |
72 | 74 | ||
73 | ```yaml | 75 | ```yaml |
74 | type: "Radarr" or "Sonarr" | 76 | type: "Lidarr", "Prowlarr", "Radarr" or "Sonarr" |
75 | apikey: "01234deb70424befb1f4ef6a23456789" | 77 | apikey: "01234deb70424befb1f4ef6a23456789" |
76 | ``` | 78 | ``` |
77 | 79 | ||
78 | The url must be the root url of Radarr/Sonarr application. | 80 | The url must be the root url of Lidarr, Prowlarr, Radarr or Sonarr application. |
79 | The Radarr/Sonarr API key can be found in Settings > General. It is needed to access the API. | 81 | The Lidarr, Prowlarr, Radarr or Sonarr API key can be found in Settings > General. It is needed to access the API. |
82 | If you are using an older version of Radarr or Sonarr which don't support the new V3 api endpoints, add the following line to your service config "legacyApi: true", example: | ||
83 | |||
84 | ```yaml | ||
85 | - name: "Radarr" | ||
86 | type: "Radarr" | ||
87 | url: "http://localhost:7878/" | ||
88 | apikey: "MY-SUPER-SECRET-API-KEY" | ||
89 | target: "_blank" | ||
90 | legacyApi: true | ||
91 | ``` | ||
80 | 92 | ||
81 | ## PaperlessNG | 93 | ## PaperlessNG |
82 | 94 | ||
83 | For Paperless you need an API-Key which you have to store at the item in the field `apikey`. | 95 | This service displays total number of documents stored. Two lines are required: |
96 | |||
97 | ```yaml | ||
98 | type: "PaperlessNG" | ||
99 | apikey: "0123456789abcdef123456789abcdef" | ||
100 | ``` | ||
101 | |||
102 | API key can be generated in Settings > Administration > Auth Tokens | ||
84 | 103 | ||
85 | ## Ping | 104 | ## Ping |
86 | 105 | ||
@@ -90,8 +109,9 @@ For Ping you need to set the type to Ping and provide a url. | |||
90 | - name: "Awesome app" | 109 | - name: "Awesome app" |
91 | type: Ping | 110 | type: Ping |
92 | logo: "assets/tools/sample.png" | 111 | logo: "assets/tools/sample.png" |
93 | subtitle: "Bookmark example" tag: "app" | 112 | subtitle: "Bookmark example" |
94 | url: "https://www.reddit.com/r/selfhosted/" | 113 | tag: "app" |
114 | url: "https://www.reddit.com/r/selfhosted/" | ||
95 | ``` | 115 | ``` |
96 | 116 | ||
97 | ## Prometheus | 117 | ## Prometheus |
@@ -105,3 +125,19 @@ For Prometheus you need to set the type to Prometheus and provide a url. | |||
105 | url: "http://192.168.0.151/" | 125 | url: "http://192.168.0.151/" |
106 | # subtitle: "Monitor data server" | 126 | # subtitle: "Monitor data server" |
107 | ``` | 127 | ``` |
128 | |||
129 | ## Portainer | ||
130 | |||
131 | This service displays info about the total number of containers managed by your Portainer instance. | ||
132 | In order to use it, you must be using Portainer version 1.11 or later. Generate an access token from the UI and pass | ||
133 | it to the apikey field. | ||
134 | |||
135 | See https://docs.portainer.io/v/ce-2.11/user/account-settings#access-tokens | ||
136 | |||
137 | ```yaml | ||
138 | - name: "Portainer" | ||
139 | logo: "assets/tools/sample.png" | ||
140 | url: "http://192.168.0.151/" | ||
141 | type: "Portainer" | ||
142 | apikey: "MY-SUPER-SECRET-API-KEY" | ||
143 | ``` | ||
diff --git a/docs/tips-and-tricks.md b/docs/tips-and-tricks.md index 17bba9a..6f1b995 100644 --- a/docs/tips-and-tricks.md +++ b/docs/tips-and-tricks.md | |||
@@ -51,7 +51,7 @@ and then simply reference these pre-defined (anchored) tags in each item like so | |||
51 | - name: "VS Code" | 51 | - name: "VS Code" |
52 | logo: "/assets/vscode.png" | 52 | logo: "/assets/vscode.png" |
53 | subtitle: "Develop Code Anywhere, On Anything!" | 53 | subtitle: "Develop Code Anywhere, On Anything!" |
54 | <<: *App # Reference to the predefined "App" Tag | 54 | <<: *Apps # Reference to the predefined "App" Tag |
55 | url: "https://vscode.example.com/" | 55 | url: "https://vscode.example.com/" |
56 | target: "_blank" # optional html tag target attribute | 56 | target: "_blank" # optional html tag target attribute |
57 | ```` | 57 | ```` |
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index ed1f85d..649e5a6 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md | |||
@@ -6,7 +6,7 @@ You might by facing a [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/C | |||
6 | It happens when the targeted service is hosted on a different domain or port. | 6 | It happens when the targeted service is hosted on a different domain or port. |
7 | Web browsers will not allow to fetch information from a different site without explicit permissions (the targeted service | 7 | Web browsers will not allow to fetch information from a different site without explicit permissions (the targeted service |
8 | must include a special `Access-Control-Allow-Origin: *` HTTP headers). | 8 | must include a special `Access-Control-Allow-Origin: *` HTTP headers). |
9 | If this happens your web console (`ctrl+shit+i` or `F12`) will be filled with this kind of errors: | 9 | If this happens your web console (`ctrl+shift+i` or `F12`) will be filled with this kind of errors: |
10 | 10 | ||
11 | ```text | 11 | ```text |
12 | Access to fetch at 'https://<target-service>' from origin 'https://<homer>' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled. | 12 | Access to fetch at 'https://<target-service>' from origin 'https://<homer>' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled. |
@@ -15,5 +15,5 @@ Access to fetch at 'https://<target-service>' from origin 'https://<homer>' has | |||
15 | To resolve this, you can either: | 15 | To resolve this, you can either: |
16 | 16 | ||
17 | * Host all your target service under the same domain & port. | 17 | * Host all your target service under the same domain & port. |
18 | * Modify the target sever configuration so that the response of the server included following header- `Access-Control-Allow-Origin: *` (<https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#simple_requests>). It might be an option in the targeted service, otherwise depending on how the service is hosted, the proxy or web server can seamlessly add it. | 18 | * Modify the target server configuration so that the response of the server included following header- `Access-Control-Allow-Origin: *` (<https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#simple_requests>). It might be an option in the targeted service, otherwise depending on how the service is hosted, the proxy or web server can seamlessly add it. |
19 | * Use a cors proxy sever like [`cors-container`](https://github.com/imjacobclark/cors-container), [`cors-anywhere`](https://github.com/Rob--W/cors-anywhere) or many others. | 19 | * Use a cors proxy server like [`cors-container`](https://github.com/imjacobclark/cors-container), [`cors-anywhere`](https://github.com/Rob--W/cors-anywhere) or many others. |