-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html
137 lines (136 loc) · 18.8 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>echGo - To send notifications via file</title>
<link rel="stylesheet" href="files/css/bootstrap.min.css">
<link rel="stylesheet" href="files/css/animate.min.css">
<link rel="stylesheet" href="files/css/style.css">
</head>
<body>
<header class="container-fluid pt-5">
<div class="row justify-content-end">
<div class="col-md-2">
<a href="https://github.com/echgo/echgo" title="echGo">
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" id="Ebene_1" x="0px" y="0px" viewBox="0 0 1035.9 773.9" style="enable-background:new 0 0 1035.9 773.9;" xml:space="preserve" class="logo">
<script xmlns=""/>
<style type="text/css">
.st0{fill-rule:evenodd;clip-rule:evenodd;fill:#77C9DB;stroke:#000000;stroke-width:10;stroke-miterlimit:10;}
.st1{fill-rule:evenodd;clip-rule:evenodd;fill:#E6F3F6;stroke:#000000;stroke-width:10;stroke-miterlimit:10;}
.st2{fill:#77C9DB;stroke:#000000;stroke-width:10;stroke-miterlimit:10;}
.st3{fill-rule:evenodd;clip-rule:evenodd;fill:#FFFFFF;}
.st4{fill-rule:evenodd;clip-rule:evenodd;fill:#020203;}
.st5{fill-rule:evenodd;clip-rule:evenodd;fill:#F6D2A3;}
.st6{fill-rule:evenodd;clip-rule:evenodd;fill:#231F20;}
</style>
<path class="st0" d="M372.8,163c-17.2,26.1-159.1,234.1-180,264.7c-1.1,1.6,0.1,3.8,2,3.8h418.1c2.1,0,3.2-2.5,1.8-4L376.6,162.7 C375.5,161.6,373.6,161.7,372.8,163z"/>
<path class="st1" d="M370,167l-59.3,87.6c-3.4,5.1-10.4,16.5-4.6,14.4l12-5c2-0.7,4.2-0.4,5.9,0.8l13.7,10.1 c2.5,1.8,5.9,1.6,8.1-0.6l20.2-19.7c1.6-1.6,3.9-2.2,6.1-1.5l49.3,14.1c3,0.9,6.2-0.6,7.4-3.4l11.6-25.4c1-2.3,0.6-5-1.1-6.9 l-59.6-65.3C377.1,163.3,372.3,163.6,370,167z"/>
<path class="st2" d="M12.9,761.2h1011.2c0.6,0,0.9-0.6,0.6-1.1L541.8,9.8c-0.3-0.5-1-0.4-1.2,0.1L373.9,390.1 c-0.2,0.5-0.9,0.6-1.2,0.1L247.1,182.3c-1.6-2.6-5.5-2.3-6.6,0.5C214.3,248.1,12.8,751.8,12.8,759.8v1.3 C12.8,761.1,12.8,761.2,12.9,761.2z"/>
<g id="Page-1">
<g id="Artboard-3" transform="translate(-173.000000, -107.000000)">
<g id="Group" transform="translate(173.000000, 107.000000)">
<path id="Shape_00000150821886528486319950000014716453155719354251_" class="st3" d="M498.9,412.8 c23.5,136.5,246.5,100.4,214.4-37.3C684.6,252.1,491.1,286.3,498.9,412.8"/>
<path id="Shape_00000095315443612387401030000003704202961460729015_" class="st4" d="M627.7,501.9 c64.5-10.8,105.7-61.5,90.4-127.5C688,245.1,485.8,280.5,494,413.1l9.8-0.6c-7.4-120.8,177.4-153.2,204.7-35.8 c13.9,59.9-23.2,105.6-82.4,115.5c-59.2,9.9-112.1-20.6-122.4-80.2l-9.7,1.7C505.3,479.1,563.6,512.7,627.7,501.9z"/>
<path id="Shape_00000005966985636720148810000008489622686143395239_" class="st3" d="M230.2,435.7 c30.4,118.9,220.6,88.4,213.4-30.8C435,262.1,201.2,289.6,230.2,435.7"/>
<path id="Shape_00000150799522907373891150000018048986114855028908_" class="st4" d="M448.4,404.6 c-4.1-68.2-60.4-106-126.2-97.4c-66.3,8.6-110.5,60-96.7,129.4l9.4-1.9c-12.7-63.6,27.4-110.1,88.5-118 c60.8-7.9,111.7,26.2,115.4,88.5c6.9,114.2-175.2,141.8-204,29.3l-9.3,2.4C257.3,560.6,456,530.4,448.4,404.6z"/>
<path id="Shape_00000028298079997408751360000018262244826535830455_" class="st3" d="M525.3,579.3c0.1,17.8,4,37.7,0.7,56.6 c-4.5,8.6-13.4,9.5-21.1,12.9c-10.6-1.7-19.5-8.6-23.7-18.5c-2.7-21.6,1-42.4,1.7-64L525.3,579.3L525.3,579.3z"/>
<path id="Shape_00000073682434247197887120000017517691729867467965_" class="st4" d="M521.2,598.6c0.7,9.1,0.9,13.5,1,18.7 c0.1,6.6-0.3,12.3-1.3,17.6l0.5-1.5c-2.1,3.9-4.7,5.5-12.4,8.2c-0.4,0.1-0.4,0.1-0.7,0.3c-2.5,0.9-3.9,1.5-5.5,2.2l2.9-0.4 c-8.9-1.4-16.3-7.2-19.9-15.5l0.4,1.4c-1.2-9.1-1.2-18.4-0.4-30.8c0.2-3.2,0.4-5.7,0.8-11.5c0.8-10.2,1.1-14.9,1.3-20.8l-6.6,4.7 l42.4,13l-3.6-4.8C520.2,584.5,520.5,588.5,521.2,598.6z M530.4,575.5l-3.6-1.1l-42.4-13l-6.4-2l-0.2,6.7 c-0.2,5.7-0.5,10.3-1.3,20.3c-0.5,5.9-0.7,8.4-0.9,11.7c-0.8,13-0.8,22.9,0.5,32.8l0.1,0.7l0.3,0.7c4.9,11.5,15.3,19.6,27.6,21.6 l1.5,0.2l1.4-0.6c1.3-0.6,2.6-1.1,4.8-1.9c0.4-0.1,0.4-0.1,0.7-0.3c9.9-3.5,14.3-6.2,18-13.1l0.4-0.7l0.1-0.8 c1.1-6,1.5-12.4,1.4-19.5c-0.1-5.5-0.3-10-1-19.3c-0.7-9.9-1-13.7-1-18.6L530.4,575.5z"/>
<ellipse id="Oval" class="st4" cx="282.5" cy="417.2" rx="32.1" ry="34.8"/>
<ellipse id="Oval_00000157298384133731104720000008930618816130346423_" class="st3" cx="297.1" cy="425" rx="7.6" ry="8.8"/>
<ellipse id="Oval_00000047779216914670170420000008652909235527609219_" class="st4" cx="550.8" cy="407.9" rx="31.6" ry="34.8"/>
<ellipse id="Oval_00000139990154393645617140000011822665045292564156_" class="st3" cx="565.2" cy="415.8" rx="7.4" ry="8.8"/>
<path id="Shape_00000063595813641390011980000000047910408542765730_" class="st3" d="M432.1,575.3c-14,34,7.8,101.9,45.8,51.8 c-2.7-21.6,1-42.4,1.7-64L432.1,575.3L432.1,575.3z"/>
<path id="Shape_00000154392219560931724420000002575911593877609094_" class="st4" d="M431.1,635.3c11.7,20.7,31.7,20.3,50.9-5.1 l1.3-1.7l-0.3-2.1c-1.2-9.1-1.2-18.4-0.4-30.8c0.2-3.2,0.4-5.7,0.8-11.5c0.8-10.2,1.1-14.9,1.3-20.8l0.2-6.8l-6.6,1.7l-47.5,12.2 l-2.5,0.6l-1,2.4C419.9,591.5,421.7,618.6,431.1,635.3z M433.4,580.3l47.5-12.2l-6.3-5.1c-0.2,5.7-0.5,10.3-1.3,20.3 c-0.5,5.9-0.7,8.4-0.9,11.7c-0.8,13-0.8,22.9,0.5,32.8l1-3.7c-15.1,19.9-26.1,20.1-33.9,6.2c-7.9-13.9-9.4-37.8-3.1-53 L433.4,580.3z"/>
<path id="Shape_00000048475907558697659060000016501672511350782897_" class="st5" d="M437,511.3c-26.1,2.2-47.5,33.3-33.9,57.9 c18,32.6,58.1-2.9,83.1,0.4c28.8,0.6,52.3,30.4,75.4,5.4c25.7-27.9-11.1-55-39.8-67.1L437,511.3L437,511.3z"/>
<path id="Shape_00000159453032540363111420000004633116547967402125_" class="st6" d="M398.6,571.7c5.8,10.6,14.3,15.8,25.1,16.4 c8,0.5,16-1.4,28.7-5.7c1.2-0.4,2.3-0.8,4-1.4c16.3-5.6,22.7-7.2,29.1-6.4l0.6,0c7.6,0.2,14.2,2.2,26.5,7.3 c14.1,5.9,18.6,7.4,25.8,8c10.1,0.8,19-2.8,27-11.5c13.6-14.8,12.9-31.1,0.7-46.1c-9.3-11.4-25.1-21.9-42.3-29.1l-1-0.4l-1.1,0 l-84.9,3.4C405.8,508.9,383.7,544.6,398.6,571.7z M522,513l-2.2-0.4c15.8,6.7,30.3,16.2,38.3,26.2c9.2,11.3,9.7,22-0.3,32.8 c-10.6,11.4-17.9,10.9-41.4,1.1c-13.4-5.6-20.9-7.9-30.2-8.1l0.6,0c-8.7-1.2-15.7,0.6-33.8,6.8c-1.8,0.6-2.8,1-4,1.4 c-23.6,8-34.2,7.4-41.6-6.1c-11.2-20.3,6.2-48.3,29.9-50.4L522,513z"/>
<path id="Shape_00000089540876742524896630000011369200404279081620_" class="st4" d="M433.7,509.9c-1.9-45.3,84.3-50.9,94.5-13 C538.3,534.7,437.9,543.5,433.7,509.9C430.3,483.2,433.7,509.9,433.7,509.9L433.7,509.9z"/>
</g>
</g>
</g>
<path class="st1" d="M537.6,18.5l-90,205.5c-1.1,2.5-0.8,5.3,0.6,7.5l28.1,42.7c2.7,4,8.2,4.5,11.5,1l49.8-53.7 c2.1-2.3,5.5-3,8.3-1.7l60.9,27.5c3.9,1.8,8.4,1.7,12.3-0.2l50.2-25.8c6.1-3,6.1-3.6,3-8.6L546.5,17.5C543.3,12.4,540,13,537.6,18.5 z"/>
<path class="st1" d="M240.4,185.4l-25.6,63.4c-0.4,0.9-0.3,2,0.1,2.9l14.5,29.6c1.2,2.4,4.5,2.7,6,0.5l10.6-14.9 c1-1.4,3-1.9,4.5-1.1l19.3,10.4c1.7,0.9,3.9,0.3,4.8-1.5l11.4-22.5c0.6-1.1,0.5-2.4-0.1-3.4l-39.4-63.9 C245.2,182.4,241.5,182.7,240.4,185.4z"/>
</svg>
</a>
</div>
</div>
</header>
<main class="container py-5">
<div class="row">
<div class="col-md-12 pb-5">
<h1>Welcome to echGo</h1>
<p class="pt-3">This small Docker project is the easiest way to send notifications directly via .txt, .json or .xml files to services like: <a href="https://gotify.net/" title="Gotify">Gotify</a>, <a href="https://pushover.net/" title="Pushover">Pushover</a>, <a href="https://matrix.org/" title="Matrix">Matrix</a>, <a href="https://telegram.org/" title="Telegram">Telegram</a>, <a href="https://discord.com/" title="Discord">Discord</a>, <a href="https://slack.com/" title="Slack">Slack</a>, <a href="https://trello.com/" title="Trello">Trello</a>, <a href="https://www.zendesk.com/" title="Zendesk">Zendesk</a>, <a href="https://osticket.com/" title="osTicket">osTicket</a>, <a href="https://www.twilio.com/" title="twillo">twillo</a> SMTP (Email) or Webhook.</p>
<p>On this page you can find a small quick guide to the software. A more detailed tutorial and all the code can be found in our <a href="https://github.com/echgo/echgo" title="GitHub repository">GitHub repository</a>. You can also view the image in the <a href="https://hub.docker.com/r/echgo/echgo" title="Docker Hub">Docker Hub</a>.</p>
<h3 class="pt-3">Quick start</h3>
<p class="pt-2">Here you can find the instructions on how to set up the Docker container and define the files so that they can be read in correctly.</p>
<h4 class="pt-3">Create the configuration files</h4>
<p class="pt-2">First, we start the Docker container to create the configuration file. For this you can use the following command.</p>
<div class="p-4 my-4 code-wrapper">
<code>docker run --name echgo-init -d --rm \<br> -v /etc/echgo/configuration:/app/files/configuration \<br> echgo/echgo:latest</code>
</div>
<p class="pt-3">If the container was started, then the directory <strong>/etc/echgo/configuration</strong> is created. Here you will find the configuration for the different communication paths. Please fill in and save this as required. If you want to adjust the configuration. You do not have to restart the Docker container again. The software reads the configuration once before each run, so it is always up-to-date. <a href="https://github.com/echgo/echgo/wiki/Configuration-File#demo-data" title="Configuration File - demo data">Here</a> you find once the file with demo data, so that you see, how the file looks. If you need more information about the individual keys and tokens, you can find them <a href="https://github.com/echgo/echgo/wiki/Environment-Variables#channel-variables" title="Environment Variables - channel variables">here</a> in the channel variables.</p>
<p>The container is stopped automatically and removed.</p>
<h4 class="pt-3">Start the service</h4>
<p class="pt-2">Now we can start the service directly. To do this, please run the following command once.</p>
<div class="p-4 my-4 code-wrapper">
<code>docker run --name echgo -d --restart always \<br> -v /etc/echgo/configuration:/app/files/configuration \<br> -v /var/lib/echgo/notification:/app/files/notification \<br> echgo/echgo:latest</code>
</div>
<p class="pt-3">Now the service should run. With the command we map once the configuration file and the location of the notifications.</p>
<h4 class="pt-3">Further adjustments</h4>
<h5 class="pt-3">Adjust interval</h5>
<p class="pt-2">If you like to adjust the interval of 15 seconds, you can do this with the following variable <strong>INTERVAL</strong>. This must be of type <strong>integer</strong>, otherwise it will not be taken into account. The whole thing looks like this.</p>
<div class="p-4 my-4 code-wrapper">
<code>docker run --name echgo -d --restart always \<br> -e INTERVAL=5 \<br> -v /etc/echgo/configuration:/app/files/configuration \<br> -v /var/lib/echgo/notification:/app/files/notification \<br> echgo/echgo:latest</code>
</div>
<p class="pt-3">With these settings, the service now reads the notifications every 5 seconds.</p>
<h5 class="pt-3">Use environments</h5>
<p class="pt-2">If you want to use environments instead of the json configuration, you can force this with the variable <strong>USE_ENVIRONMENT</strong>. This value is a <strong>boolean</strong>. This is the way json configuration is taken no longer.</p>
<div class="p-4 my-4 code-wrapper">
<code>docker run --name echgo -d --restart always \<br> -e USE_ENVIRONMENT=true \<br> -v /etc/echgo/configuration:/app/files/configuration \<br> -v /var/lib/echgo/notification:/app/files/notification \<br> echgo/echgo:latest</code>
</div>
<p class="pt-3">Now you can use the following variables for the different services. If a service is running notification file but has no access data stored, the notification will not be executed. A list of all variables can be found <a href="https://github.com/echgo/echgo/wiki/Environment-Variables#channel-variables" title="Environment Variables - channel variables">here</a>.</p>
<h4 class="pt-3">Create notification</h4>
<p class="pt-2">Now we create a notification to be sent to different channels. You can also enter only one channel. How these notification files are created later is up to you. With a bash script or from another program does not matter.</p>
<p>The only important thing is that the file is placed in this folder <strong>/var/lib/echgo/notification</strong>. The name of the file does not matter. It only matters that the file extension and the file format are correct. Currently, we can read the following formats: <strong>.txt, .json & .xml</strong>.</p>
<p>Yu can store the following channels in the file, if they are configured: <strong>gotify, pushover, matrix, telegram, discord, slack, trello, zendesk, osticket, twillo, smtp & webhook</strong>. These are always specified in an array. That means you can address one or more channels with one notification file. Now let's look at the currently available file formats and how you can configure them.</p>
<h5 class="pt-3">TXT file</h5>
<p class="pt-2">Now let's have a look at an example .txt file. The name of the file can always be freely chosen. It is only important that the data are set per line and that these are stored as key value pairs.</p>
<p>Notification channels can be listed comma separated. If you want to use only one channel, you don't have to use a comma.</p>
<div class="p-4 my-4 code-wrapper">
<code>channels=gotify,telegram<br>headline=Nice headline<br>message=This is a test message!</code>
</div>
<h5 class="pt-3">JSON file</h5>
<p class="pt-2">Here you can find an example for a .json file. Here you can also enter several or only one channel. The structure of the file must be followed please. If you want to know more about JSON, you can find the official site <a href="https://www.json.org/json-en.html" title="Official site">here</a>.</p>
<div class="p-4 my-4 code-wrapper">
<code>{<br> "channels": [<br> "gotify",<br> "matrix",<br> "zendesk"<br> ],<br> "headline": "Nice headline",<br> "message": "This is a test message."<br>}</code>
</div>
<h5 class="pt-3">XML file</h5>
<p class="pt-3">The file type .xml can also be used. The structure of the file looks as follows. If you need to XML, you can find it <a href="https://www.xml.com/" title="Website">here</a>.</p>
<div class="p-4 my-4 code-wrapper">
<code><data><br> <channels><br> <type>gotify</type><br> <type>discord</type><br> </channels><br> <headline>echGo</headline><br> <message>This is a test message from a xml file.</message><br></data></code>
</div>
<p class="pt-3">Now echGo reads the files every 15 seconds and sends them to the specified channels. It is also possible to read in several files of different types at the same time.</p>
<p>This is only an excerpt and the instructions for a quick start. You can find the complete documentation on <a href="https://github.com/echgo/echgo" title="GitHub">GitHub</a>.</p>
</div>
</div>
</main>
<footer>
<div class="container-fluid fixed-bottom bg-black">
<div class="row py-2">
<div class="col-md-12 d-flex justify-content-end">
<ul class="list-unstyled d-flex m-0">
<li class="ml-3">
<a href="imprint.html" title="Imprint" class="text-white">Imprint</a>
</li>
<li class="ml-3">
<a href="privacy.html" title="Privacy" class="text-white">Privacy</a>
</li>
</ul>
</div>
</div>
</div>
<script src="./files/js/jquery-3.3.1.slim.min.js"></script>
<script src="./files/js/popper.min.js"></script>
<script src="./files/js/bootstrap.min.js"></script>
</footer>
</body>
</html>