ryback2501/kairizon repository overview

⁠Kairizon

A self-hosted Amazon price checker. Add product URLs, set a target price, and receive an email the moment the price drops to or below your threshold. Optionally get notified when an out-of-stock item becomes available again.

⁠Features

• Check Amazon product prices by URL
• Set a target price and receive an HTML email alert when the price hits it
• Get notified when an out-of-stock product becomes available again
• Filter out second-hand listings or specific sellers per product
• Jump to each product's price history on camelcamelcamel.com⁠ with one click (supported Amazon marketplaces only)
• Configure email notifications directly from the UI — no config files needed
• Customisable HTML email templates — edit email-price-alert.html and email-stock-alert.html in your data folder
• Set the scraper locale to match your regional Amazon site
• Runs entirely on your own machine; no accounts, no subscriptions

⁠Environment variables

⁠Run it

docker run -d \
  --name kairizon \
  -v ~/kairizon/data:/app/data \
  -p 3000:3000 \
  --restart unless-stopped \
  ryback2501/kairizon:latest

Data is persisted in ~/kairizon/data/ by default. On first run the app creates the database and the email template files in that folder. You can customise the templates at any time — they are never overwritten on subsequent runs.

You can also set the database filename and scraper locale via environment variables:

docker run -d \
  --name kairizon \
  -v ~/kairizon/data:/app/data \
  -p 3000:3000 \
  -e DATABASE_FILE=mydata.db \
  --restart unless-stopped \
  ryback2501/kairizon:latest

In both examples the app runs at http://localhost:3000.

⁠Documentation

Full setup instructions, manual install options, and self-hosting notes available in the GitHub repository⁠.

⁠Contribute!

Check the Contributing section in the Readme file of the repository.