# Discord Notifier This repository contains the source code for a ssh login notification service. When running this software will send discord messages to a channel of your choice on shh logins. In addition to the code needed to send these messages, this also includes the code for a server and install script. When used together these programs will automate the process of configuring a discord webhook for a server of your choice and installing the notification system on your machine. If you would like you can actually pay money for this software. If you do that I'll provide support over email if things do not work like you might expect. [Here](https://buy.stripe.com/3cs4jc2q09ug90IbII) is a link where you can do that. The reccomended setup is to run this software on your syslogs server so that notifications will be sent for logins on all machines involved. ## Using the install script If you would just like to install a discord-notifier on a machine that you run you can use the install script in `/client/install.sh`. Running `sudo bash install.ssh` will prompt you to open a discord url for authentication and then install the notifier. Running as root is needed as the script needs to modify the rsyslog configuration on your machine. ## Organization - `/server` contains the source code for a server which is needed to communicate with the Discord API and configure a webhook automatically. - `/client` contains the source code for a client side install script. - `/workers-server` contains the source code for a Cloudflare Workers version of `/server`. This version is equally functional as `/server` but high latency for Workers KV write propogration makes `/server` preferable for most use cases. ## Deploying yourself Each folder listed above has a README file which contains information about deploying that component. You can read more about how this all fits together in the initial functional spec for this work [here](intro-spec.md).