Known issues and mitigations

Version 0.1.0 Updated Nov 08, 2025
  • TimeZone errors: The embedded cluster loads timezone data from the host tzdata package. Install it inside the execution environment if you see invalid value for parameter "TimeZone": "UTC".
  • Download rate limits: postgresql_embedded fetches binaries from the Theseus GitHub releases. Supply a GITHUB_TOKEN environment variable if you hit rate limits in CI.
  • CLI arguments in tests: PgEnvCfg::load() ignores std::env::args during library use so Cargo test filters (for example, bootstrap_privileges::bootstrap_as_root) do not trip the underlying Clap parser. Provide configuration through environment variables or config files when embedding the crate.
  • Legacy with_temp_euid helper: The helper now returns an error because the library no longer mutates the process UID mid-test. Configure PG_EMBEDDED_WORKER instead so the subprocess performs the privilege drop.