docker-detector 1.0.0

Detect if your Python process is running inside a Docker container — inspired by the popular is-docker npm package. Works on Linux, with optional cache refresh for repeated checks.

Docker Detector

Detect if your Python process is running inside a Docker container — inspired by the popular is-docker npm package. Works on Linux, with optional cache refresh for repeated checks.

Features

• Fast and reliable Docker container detection
• Multiple detection methods for robustness
• Cached results for performance optimization
• Zero dependencies, minimal overhead
• Type hints for better IDE support

Installation

pip install docker-detector

Or using uv:

uv add docker-detector

Usage

Check if running inside Docker

from docker_detector import is_docker

if is_docker():
    print("Running inside a Docker container")
else:
    print("Not running inside a Docker container")

Force refresh cache

from docker_detector import is_docker

# Use cached result (default)
is_docker()  # Fast, uses cache

# Force a fresh check, bypassing cache
is_docker(force_refresh=True)  # Performs new detection

Credits

This package is inspired by the is-docker npm package by Sindre Sorhus.

Changelog

See CHANGELOG.md for a detailed list of changes and version history.

Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct, development setup, and the process for submitting pull requests.

Support

If you find this library useful, please consider:

• ⭐ Starring the repository on GitHub to help others discover it.
• 💖 Sponsoring to support ongoing maintenance and development.

Become a Sponsor on GitHub | Support on Patreon

License

MIT License - see LICENSE file for details.

Author

Y. Siva Sai Krishna

• GitHub: @ysskrishna
• LinkedIn: ysskrishna