foxxmd/endlessh-notify repository overview

Event notification for endlessh⁠ and endlessh-go⁠

⁠What Does It Do?

endlessh-notify tails the logs from your endlessh instance and will send notifications using Discord webhooks⁠, ntfy⁠, and gotify⁠ when any of these events occurs:

• New* IP tries to connect
• New* IP disconnect (coming soon)

*You can control how an IP is considered "new" based on when it was last seen.

⁠Prerequisites

• A running endlessh⁠ or endlessh-go⁠ instance with file logging enabled.
  • Access to log files
• A Discord webhook⁠, running ntfy⁠ instance, or running gotify⁠ instance

⁠Quick Start

Assuming:

• Using docker
• Endlessh log files are located at /home/user/endlessLogs on your host system
• A discord webhook https://discord.com/api/webhooks/MY_WEBHOOK
• Notify if IP from event hasn't been seen before or was last seen more than 24 hours ago

docker run -d -e DISCORD_WEBHOOK="https://discord.com/api/webhooks/MY_WEBHOOK" -e DEBOUNCE_INTERVAL="1 day" -v /home/user/endlessLogs:/endlessh foxxmd/endlessh-notify

See full documentation in the repo⁠