Skip to content

homelabforge/tidewatch

Intelligent Docker Container Update Management

CI CodeQL Publish

Docker Python 3.14 React 19 Bun License: MIT Discord


TideWatch Dashboard


Key Features

  • Real-time Container Monitoring - Live status updates with Server-Sent Events
  • Intelligent Update Management - Schedule updates with dependency ordering
  • Self-Healing Rollback - Pre-update data backup with full volume/mount restore on rollback
  • Auto-Restart with Backoff - Exponential backoff for failed containers
  • Dependency Tracking - Monitor npm, PyPI, Composer, Cargo, and Go modules
  • 7 Notification Services - Gotify, Pushover, Slack, Discord, Telegram, Email, ntfy
  • OIDC/SSO Support - Enterprise authentication (Authentik, Keycloak, Google, Microsoft)
  • Database Encryption - AES-128 encryption for sensitive fields
  • Light/Dark Theme - Automatic system preference detection
  • Self-Hosted - Your data stays on your infrastructure

Default Mode: Runs with no authentication for easy setup. Configure authentication in Settings before exposing to the internet.

📖 Complete Installation Guide

Development

Backend tests run inside a Python 3.14 container (the host typically runs 3.13, and the production image has no pytest). A wrapper handles the build + mount + docker socket plumbing:

backend/scripts/run-tests.sh                    # full suite
backend/scripts/run-tests.sh tests/test_foo.py  # subset
backend/scripts/run-tests.sh -k self_managed    # filter
backend/scripts/run-tests.sh --build            # force rebuild test image

See backend/Dockerfile.test for the test image definition.

Support


License

MIT License - see LICENSE file for details.


Acknowledgments

Built for homelabbers who want intelligent container update management without relying on third-party services.

Part of the HomelabForge ecosystem.

Development Assistance

TideWatch was developed through AI-assisted pair programming with Claude and Codex, combining human vision with AI capabilities for architecture, security patterns, and implementation.

About

Intelligent Docker Container Update Manager for Homelabs - Real-time monitoring, intelligent scheduling, auto-restart, and notification services

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors