Get Real-Time Notifications with Wanderer Notifier
Download and run Wanderer Notifier to receive real-time notifications in your Discord channel. Learn how to get started with our Docker image and discover the different alerts you'll receive.
Get Real-Time Notifications with Wanderer Notifier
Wanderer Notifier delivers real-time alerts directly to your Discord channel, ensuring you never miss critical in-game events. Whether it’s a significant kill, a newly tracked character, or a fresh system discovery, our notifier keeps you informed with rich, detailed notifications.
In the fast-paced universe of EVE Online, timely information can mean the difference between success and failure. When a hostile fleet enters your territory, when a high-value target appears in your hunting grounds, or when a new wormhole connection opens up valuable opportunities - knowing immediately gives you the edge. Wanderer Notifier bridges this information gap, bringing critical intel directly to your Discord where your team is already coordinating.
Prerequisites
Before setting up Wanderer Notifier, ensure you have the following:
- A Discord server where you have administrator permissions
- Docker and Docker Compose installed on your system
- Basic knowledge of terminal/command line operations
- Your Wanderer map URL and API token
- A Discord bot token (see our guide on creating a Discord bot)
How to Get Started
There are two ways to install Wanderer Notifier: a Quick Install option using a one-liner, or a Manual Setup for those who prefer step-by-step control.
Quick Install Option
For a streamlined installation that creates the necessary directory and files automatically, run:
curl -fsSL https://gist.githubusercontent.com/guarzo/3f05f3c57005c3cf3585869212caecfe/raw/wanderer-notifier-setup.sh | bash
Once the script finishes, update the wanderer-notifier/.env
file with your configuration values, then proceed to Step 4.
Manual Setup
If you’d rather set up everything manually, follow these steps:
1. Download the Docker Image
Pull the latest Docker image:
docker pull guarzo/wanderer-notifier:latest
2. Configure Your Environment
Create a .env
file in your working directory with the following content. Replace the placeholder values with your actual credentials:
# Required Configuration
DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_CHANNEL_ID=your_discord_channel_id
MAP_URL_WITH_NAME="https://wanderer.ltd/<yourmap>"
MAP_TOKEN=your_map_api_token
# Map Subscription Configuration (for enhanced features)
# Note: Premium features are enabled with your map subscription
LICENSE_KEY=your_map_license_key # Provided with your map subscription
# Notification Control (all enabled by default)
# ENABLE_KILL_NOTIFICATIONS=true
# ENABLE_CHARACTER_TRACKING=true
# ENABLE_CHARACTER_NOTIFICATIONS=true
# ENABLE_SYSTEM_NOTIFICATIONS=true
# TRACK_ALL_SYSTEMS=false
Note: If you don’t have a Discord bot yet, follow our guide on creating a Discord bot or search the web for more information.
3. Create the Docker Compose Configuration
Create a file named docker-compose.yml
with the following content:
services:
wanderer_notifier:
image: guarzo/wanderer-notifier:latest
container_name: wanderer_notifier
restart: unless-stopped
environment:
- DISCORD_BOT_TOKEN=${DISCORD_BOT_TOKEN}
- DISCORD_CHANNEL_ID=${DISCORD_CHANNEL_ID}
- MAP_URL_WITH_NAME=${MAP_URL_WITH_NAME}
- MAP_TOKEN=${MAP_TOKEN}
- LICENSE_KEY=${LICENSE_KEY}
ports:
- 4000:4000
volumes:
- wanderer_data:/app/data
healthcheck:
test: ["CMD", "wget", "-q", "--spider", "http://localhost:${PORT:-4000}/health"]
interval: 30s
timeout: 3s
retries: 3
start_period: 10s
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
volumes:
wanderer_data:
Note: If you used the quick install option, these files have already been created for you.
4. Run It
Start the service with Docker Compose:
docker-compose up -d
Your notifier is now up and running, delivering alerts to your Discord channel automatically!
Notification Types
Wanderer Notifier supports three main notification types, each tailored based on your map subscription status.
Kill Notifications
When a kill occurs in a tracked system or involves a tracked character:
-
With Premium Map Subscription:
Receives a rich embed that includes:- Ship thumbnail image
- Detailed information about both victim and attacker
- Links to zKillboard profiles
- Ship type details
- ISK value of the kill
- Corporation logos
- A clickable link on the final blow character to zKillboard
-
With Free Map:
Displays a basic text notification containing:- Victim name
- Ship type lost
- System name
Character Tracking Notifications
When a new character is added to your tracked list:
-
With Premium Map Subscription:
You get a rich embed featuring:- Character portrait
- Corporation details
- Direct link to the zKillboard profile
- Formatted timestamp
-
With Free Map:
Receives a simple text notification that includes:- Character name
- Corporation name (if available)
System Notifications
When a new system is discovered or added to your map:
-
With Premium Map Subscription:
Shows a rich embed with:- System name (including aliases/temporary names)
- System type icon
- Region information or wormhole statics
- Security status
- Recent kills in the system
- Links to zKillboard and Dotlan
-
With Free Map:
Provides a basic text notification including:- Original system name (for wormholes)
- System name (for k-space)
Map Subscription Features & Limitations
Wanderer Notifier offers enhanced functionality with a premium map subscription while still providing robust features for free maps.
Free Version Features
- Core Notifications: Basic text notifications for systems and characters.
- Web Dashboard: View system status and subscription information.
- Unlimited Tracking: Track an unlimited number of systems and characters.
- Notification History: 24-hour retention of notification history.
Premium Map Subscription Enhancements
- Rich Notifications: Enhanced embeds with images, links, and detailed data.
- Interactive Elements: Clickable links to zKillboard profiles and additional resources.
- Enhanced System Information: Comprehensive data including region details, security status, and wormhole statics.
- Recent Activity: Access to recent kill data in newly mapped systems.
- Upcoming Features: Daily reporting on tracked character activity, structure notifications, ACL notifications, and Slack notifications.
How to Subscribe
To unlock the enhanced features of Wanderer Notifier:
- Visit our Map Subscriptions page to learn about subscription options
- Subscribe to any premium map tier to receive your map subscription key
-
Add your map subscription key to the LICENSE_KEY field in your
.env
file - Restart the notifier to apply your subscription benefits
For more details on map subscription tiers and pricing, see our complete guide to map subscriptions.
Feature Comparison
Feature | Free Map | Premium Map Subscription |
---|---|---|
Kill Tracking | Unlimited | Unlimited |
System Tracking | Unlimited | Unlimited |
Character Tracking | Unlimited | Unlimited |
Notification Format | Basic Text | Rich Embeds |
Web Dashboard
Wanderer Notifier includes a web dashboard that provides real-time insights into your notification system:
-
Access: Visit
http://localhost:4000
to view the dashboard. - System Status: Monitor system details, subscription information, and notification statistics.
- Resource Monitoring: Keep an eye on resource usage and feature availability.
- Notification Testing: Test notifications directly from the dashboard.
Premium map subscribers also gain access to detailed statistics and advanced visualization tools.
Configuration Options
Customize your notification experience with several configuration options available through environment variables.
Notification Control Variables
- ENABLE_KILL_NOTIFICATIONS: Enable/disable kill notifications (default: true).
- ENABLE_CHARACTER_TRACKING: Enable/disable character tracking (default: true).
- ENABLE_CHARACTER_NOTIFICATIONS: Enable/disable notifications when new characters are added (default: true).
- ENABLE_SYSTEM_NOTIFICATIONS: Enable/disable system notifications (default: true).
Note:
- Character Tracking: Determines whether the application monitors characters.
- Character Notifications: Controls whether you receive Discord alerts when new characters are added.
To disable a notification type, set the corresponding variable to false
or 0
in your .env
file:
# Example: Disable kill notifications while keeping other notifications enabled
ENABLE_KILL_NOTIFICATIONS=false
Troubleshooting
If you encounter issues with Wanderer Notifier, here are solutions to common problems:
No Notifications Appearing
- Check Bot Permissions: Ensure your bot has the “Send Messages” and “Embed Links” permissions in the Discord channel.
- Verify Channel ID: Double-check your DISCORD_CHANNEL_ID in the .env file.
-
Check Container Logs: Run
docker logs wanderer_notifier
to see if there are any error messages. -
Test API Connection: Visit
http://localhost:4000/health
to verify the service is running.
Connection Issues
- Network Configuration: Ensure port 4000 is not blocked by your firewall.
-
Docker Status: Run
docker ps
to verify the container is running. -
Restart Service: Try
docker-compose restart
to refresh the connection.
Subscription Not Recognized
- Check Map Token: Ensure your MAP_TOKEN is correct and associated with your map.
- Verify LICENSE_KEY: Make sure you’ve entered the correct map subscription key in your .env file.
-
Verify Status: Check the dashboard at
http://localhost:4000
to see subscription status. -
Restart After Subscribing: If you’ve recently subscribed, restart the notifier with
docker-compose restart
.
For additional support, join our Discord community or email support@wanderer.ltd.
Updating Wanderer Notifier
To ensure you have the latest features and security updates, periodically update your Wanderer Notifier installation:
Automatic Updates
The Docker image is configured to check for updates daily. To manually trigger an update:
# Navigate to your wanderer-notifier directory
cd wanderer-notifier
# Pull the latest image
docker-compose pull
# Restart the container with the new image
docker-compose up -d
Update Notifications
When significant updates are available, you’ll receive a notification in your Discord channel. These updates may include:
- New notification types
- Enhanced visualization features
- Security improvements
- Bug fixes
Preserving Your Configuration
Updates preserve your existing configuration and data. Your .env
file and tracked entities will remain intact through the update process.
Conclusion
Wanderer Notifier is engineered to keep you informed of crucial in-game events effortlessly. The free version provides unlimited tracking with basic notifications, while premium map subscribers receive rich, detailed alerts with enhanced features.
By following either the quick install or manual setup process, you’ll have the notifier running in no time—delivering real-time alerts directly to your Discord channel so you can focus on what matters most in your gameplay.
For further support or questions, please contact the Wanderer Team.
Stay vigilant and enjoy your real-time alerts!