{"id":24863,"library":"zdaemon","title":"zdaemon","description":"zdaemon is a library and set of tools for controlling daemon processes on Unix-based systems. It provides a robust way to start, stop, and manage background processes, commonly used in Zope and Plone deployments. Current version is 5.2.1, released with a slow cadence.","status":"active","version":"5.2.1","language":"python","source_language":"en","source_url":"https://github.com/zopefoundation/zdaemon","tags":["daemon","process control","zope","unix"],"install":[{"cmd":"pip install zdaemon","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required at install time for entry points.","package":"setuptools","optional":false}],"imports":[{"note":"zdctl is a submodule; direct import fails in recent versions.","wrong":"import zdctl","symbol":"zdctl","correct":"from zdaemon import zdctl"},{"note":"zdrun is a submodule; direct import fails.","wrong":"import zdrun","symbol":"zdrun","correct":"from zdaemon import zdrun"}],"quickstart":{"code":"from zdaemon import zdctl\n# Show help for the zdctl command-line tool\nprint(zdctl.__file__)","lang":"python","description":"Basic import of the zdctl module to verify installation."},"warnings":[{"fix":"Update all imports to use the 'from zdaemon import ...' pattern.","message":"In version 5.0, the import paths changed. Top-level imports like 'import zdctl' no longer work. Use 'from zdaemon import zdctl'.","severity":"breaking","affected_versions":">=5.0"},{"fix":"Use 'zdaemon.zdctl' or 'zdaemon.zdrun' instead.","message":"The 'zdaemon.zdoptions' module is deprecated and may be removed in a future release.","severity":"deprecated","affected_versions":">=5.0"},{"fix":"Use: zdctl -C /path/to/zd.conf","message":"Running 'zdctl' without a proper configuration file will fail silently. Always specify a '--config' or '-C' option.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'5.2.1':41 'background':29 'base':17 'cadenc':46 'common':31 'control':11,49 'current':38 'daemon':12,47 'deploy':37 'librari':5 'manag':28 'plone':36 'process':13,30,48 'provid':20 'releas':42 'robust':22 'set':7 'slow':45 'start':25 'stop':26 'system':18 'tool':9 'unix':16,51 'unix-bas':15 'use':32 'version':39 'way':23 'zdaemon':1,2 'zope':34,50","created_at":"2026-05-01T08:15:18.713142+00:00","updated_at":"2026-05-01T08:15:18.713142+00:00","problems":[{"fix":"Use 'from zdaemon import zdctl'.","cause":"Attempting to import zdctl directly instead of from zdaemon.","error":"ModuleNotFoundError: No module named 'zdctl'"},{"fix":"Provide a valid subcommand, e.g., 'zdctl status' or 'zdctl -C config.conf start'.","cause":"Running zdctl without any subcommand or configuration.","error":"zdctl: error: too few arguments"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"5.2.1","cli_name":"zdaemon","cli_version":"5.2.1","type":"library","homepage":null,"github":"https://github.com/zopefoundation/zdaemon","docs":null,"changelog":null,"pypi":"https://pypi.org/project/zdaemon/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}