A self-hosted tool to monitor iOS App Store apps for new releases and automatically notify you.
2.4K
A self-hosted tool to monitor iOS App Store apps for new releases and automatically notify you in Discord. Features a web interface for easy management of multiple apps.
If you don't have Docker installed, download it from docker.com.
Create a file named docker-compose.yml in a folder on your computer. Copy and paste this content:
services:
app-watch:
image: rajnishdock/app-watch:latest
container_name: app-watch
restart: unless-stopped
ports:
- "8192:8192"
volumes:
- ./data:/data
Note: The ./data folder will be created automatically to store your app settings and version tracking data.
Open a terminal (Command Prompt on Windows, Terminal on Mac/Linux) in the folder where you created docker-compose.yml and run:
docker compose up -d
Wait a few seconds for it to start, then open your web browser and go to:
Before adding apps, you need a Discord webhook:
https://apps.apple.com/app/id123456789/id (that's your App Store ID)6h, 1d, etc.You can add more apps by clicking "Add App" again. Each app can use a different Discord channel.
The application periodically checks the App Store API for new versions of your configured apps. When a new version is detected, it automatically formats the release notes and posts them to your Discord channel via webhook.
6h for 6 hours, 1d for daily)The application automatically formats release notes from the App Store for better readability in Discord. It detects structured sections and formats them accordingly.
Original App Store release notes:
New:
- Dark mode support
- New dashboard design
Improvements:
- Faster app startup
- Better error handling
Fixed:
- Crash on login
- Memory leak issue
Formatted output in Discord:
# v2.3.1
## New
- Dark mode support
- New dashboard design
## Improvements
- Faster app startup
- Better error handling
## Fixed
- Crash on login
- Memory leak issue
The formatter automatically detects and makes these section headers bold (as ## headers in Discord):
If your release notes don't have these section headers, they'll be formatted as a simple bullet list with the version number.
Original App Store release notes:
This release includes bug fixes and performance improvements.
We've also added support for iOS 17.
Formatted output in Discord:
# v2.3.1
- This release includes bug fixes and performance improvements.
- We've also added support for iOS 17.
The formatting behavior can be customized by modifying the formatter configuration in the source code. The formatter recognizes common section headers and can be extended to support additional patterns if needed.
Start the application:
docker compose up -d
Stop the application:
docker compose down
Restart the application:
docker compose restart
View logs:
docker logs app-watch
View logs in real-time:
docker logs -f app-watch
Using Docker Run (without Docker Compose):
docker run -d \
--name app-watch \
--restart unless-stopped \
-p 8192:8192 \
-v $(pwd)/data:/data \
rajnishdock/app-watch:latest
Building from Source:
If you want to build from source or make modifications:
# Clone the repository
git clone https://github.com/YOUR_USERNAME/app-watch.git
cd app-watch
# Build frontend
cd frontend
npm install
npm run build
cd ..
# Build and run with Docker Compose
docker compose build
docker compose up -d
All your app configurations and version tracking data are stored in the data folder in the same directory as your docker-compose.yml file:
data/apps.json - App configurations (names, IDs, webhooks, intervals)data/apps/<APP_ID>/version.txt - Last posted version for each appdata/apps/<APP_ID>/check.txt - Last check timestamp for each appImportant: If you delete the data folder, you'll lose all your app configurations and version tracking.
The docker-compose.yml file supports many configuration options. Here's a comprehensive example with all possible values:
services:
app-watch:
# Image configuration
image: rajnishdock/app-watch:latest # Docker image to use
container_name: app-watch # Custom container name (optional)
# Restart policy
restart: unless-stopped # Options: no, always, on-failure, unless-stopped
# Port mapping (host:container)
ports:
- "8192:8192" # Format: "HOST_PORT:CONTAINER_PORT"
# Alternative formats:
# - "8192:8192/tcp" # Specify protocol
# - "127.0.0.1:8192:8192" # Bind to specific host IP
# Volume mounts
volumes:
- ./data:/data # Local path:container path
# Alternative formats:
# - /docker-data/app-watch/data:/data # Absolute path
# - app-watch-data:/data # Named volume (requires volumes: section)
# Environment variables
environment:
- CHECK_INTERVAL=12h # Default check interval (12h, 6h, 1d, 30m, etc.)
- PORT=8192 # Server port (default: 8192)
- TZ=America/New_York # Timezone (optional, e.g., UTC, Europe/London)
- APP_VERSION=1.0.0 # App version override (optional)
# Alternative: use env_file
# env_file:
# - .env # Load from .env file
# - .env.local # Multiple files supported
# Networks (optional)
networks:
- app-watch-network # Custom network name
# Or use default network
# Health check (optional)
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8192/api/status"]
interval: 30s # Check every 30 seconds
timeout: 10s # Timeout after 10 seconds
retries: 3 # Retry 3 times before marking unhealthy
start_period: 40s # Grace period on startup
# Resource limits (optional)
deploy:
resources:
limits:
cpus: '1.0' # CPU limit (1.0 = 1 CPU core)
memory: 512M # Memory limit
reservations:
cpus: '0.5' # CPU reservation
memory: 256M # Memory reservation
# Logging configuration (optional)
logging:
driver: "json-file" # Options: json-file, syslog, journald, gelf, fluentd, awslogs, splunk, etwlogs, none
options:
max-size: "10m" # Max log file size
max-file: "3" # Number of log files to keep
# Labels (optional)
labels:
- "com.example.description=App Store Release Watcher"
- "com.example.version=1.0"
# User and permissions (optional)
# user: "1000:1000" # Run as specific user:group (UID:GID)
# Working directory (optional)
# working_dir: /app # Override working directory
# Command override (optional)
# command: ["python", "-m", "backend.app", "--custom-arg"]
# Entrypoint override (optional)
# entrypoint: ["/custom-entrypoint.sh"]
# Security options (optional)
# security_opt:
# - no-new-privileges:true
# Capabilities (optional)
# cap_add:
# - NET_ADMIN
# cap_drop:
# - ALL
# Shared memory size (optional)
# shm_size: '64mb'
# Dependencies (optional)
# depends_on:
# - database
# - redis
# Named volumes (if using named volumes)
# volumes:
# app-watch-data:
# driver: local
# # Optional volume options:
# # driver_opts:
# # type: none
# # o: bind
# # device: /path/to/data
# Networks (if using custom networks)
# networks:
# app-watch-network:
# driver: bridge
# # Optional network options:
# # ipam:
# # config:
# # - subnet: 172.20.0.0/16
| Variable | Description | Default | Format/Examples |
|---|---|---|---|
CHECK_INTERVAL | Default check interval for apps without custom intervals | 12h | 30m, 6h, 12h, 1d, 7d |
PORT | Server port number | 8192 | Any valid port number (e.g., 3000, 8080) |
TZ | Timezone for timestamps and logging | System timezone | UTC, America/New_York, Europe/London, Asia/Tokyo |
APP_VERSION or VERSION | Application version override | Auto-detected | Version string (e.g., 1.0.0) |
no: Do not automatically restart the container (default)always: Always restart the container if it stopson-failure: Restart the container if it exits due to an errorunless-stopped: Always restart the container unless it is explicitly stopped./data:/data or /absolute/path:/data - Maps a host directory to container directoryapp-watch-data:/data - Uses Docker-managed volume (requires volumes: section)./data:/data:ro - Mount as read-only"8192:8192" - Map host port 8192 to container port 8192"127.0.0.1:8192:8192" - Bind to specific host IP only"8192:8192/tcp" - Specify protocol (tcp/udp)"8192:8192/udp" - UDP protocolThe health check verifies the container is running correctly by checking the /api/status endpoint. You can customize:
interval: Time between health checkstimeout: Maximum time to wait for a responseretries: Number of consecutive failures before marking unhealthystart_period: Grace period on startup before health checks countUse the deploy.resources section to limit container resources:
limits: Maximum resources the container can usereservations: Guaranteed minimum resourcesNote: The deploy section is primarily for Docker Swarm, but some options work with docker compose. For standalone Docker Compose, you can also use deprecated but still functional options:
mem_limit: 512m
cpus: 1.0
Common logging driver options:
json-file: Default, logs to JSON files (supports max-size and max-file options)syslog: Send logs to syslogjournald: Send logs to systemd journal (Linux only)none: Disable loggingEach app can be configured individually through the web interface:
6h, 30m, 1d)Port already in use:
lsof -i :8192 or netstat -an | grep 8192netstat -ano | findstr :8192docker-compose.yml if neededPermission issues:
chmod 755 ./data (if the folder exists)./data folder will be created automatically with proper permissionsDocker not running:
docker psWebhook URL issues:
https://discord.com/api/webhooks/curl -X POST -H "Content-Type: application/json" \
-d '{"content":"Test message"}' \
YOUR_WEBHOOK_URL
Webhook deleted or invalid:
No notifications received:
docker logs app-watchApp Store ID incorrect:
https://apps.apple.com/app/id<YOUR_ID>apps.apple.com/app/id123456789Check interval too long:
30m for testing)App Store API issues:
docker logs app-watch"Invalid Discord webhook URL"
https://discord.com/api/webhooks/discordapp.com, update it to discord.com"App Store ID must be a number"
https://apps.apple.com/app/id123456789, use 123456789"Invalid interval format"
<number><unit> where unit is m (minutes), h (hours), or d (days)30m, 6h, 12h, 1d, 7dContent type
Image
Digest
sha256:08ba2b601…
Size
56.5 MB
Last updated
14 days ago
docker pull rajnishdock/app-watch