Skip to content

Commit 69bcbf3

Browse files
committed
add screenshot to docs directory
1 parent c33e5c5 commit 69bcbf3

File tree

2 files changed

+61
-0
lines changed

2 files changed

+61
-0
lines changed

docs/INSTALL.md

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
2+
# How to start Naglite4
3+
4+
Naglite4 requires
5+
6+
## Enable Icinga2 API and setup API user
7+
8+
1. Make sure your Icinga2 can provide API.
9+
10+
```bash
11+
# check if Icinga 2 API is enabled
12+
icinga2 feature enable api
13+
# if not enabled, run API setup
14+
icinga2 api setup
15+
```
16+
17+
2. Create API user by adding following to Icinga2 config
18+
19+
```
20+
object ApiUser "naglite"{
21+
password = "enter-your-secret-password-here"
22+
23+
permissions = [
24+
"objects/query/Host",
25+
"objects/query/Service",
26+
"events/*", // not really needed
27+
"status/query" // not really needed
28+
]
29+
}
30+
```
31+
32+
3. Reload Icinga2 with updated config.
33+
34+
```bash
35+
# check your Icinga2 config is valid
36+
icinga2 daemon validate
37+
38+
# reload Icinga
39+
systemctl reload icinga2
40+
```
41+
42+
## Start Naglite4
43+
44+
1. Setup Naglite together with its dependencies. (or use provided RPM).
45+
46+
2. Start the Flask application service - example systemd unit
47+
starts appliction on `127.0.0.1:4080`
48+
49+
## Connect web server with application
50+
51+
2. Forward requests from webserver to the started Flask application.
52+
53+
```nginx
54+
location /naglite4/ {
55+
proxy_pass http://localhost:4080/;
56+
}
57+
location /naglite4/static/ {
58+
proxy_pass http://localhost:4080/naglite4/static/ ;
59+
}
60+
```
61+

docs/naglite4.png

23.4 KB
Loading

0 commit comments

Comments
 (0)