Known issues and mitigations

Version 0.5.2 Updated Jul 20, 2026
  • 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.
  • Windows on ARM: aarch64-pc-windows-msvc is not published or tested because upstream PostgreSQL binaries are not available for that target.
  • Windows directory privacy: POSIX 0700/0755 modes are skipped on Windows. Use private directories or explicit ACLs when the generated .pgpass file and data directory must be hidden from other local accounts.
  • 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.