Repository navigation
Release Notes - TLS Certificate Setup Improvements (macOS)
Summary
This release improves Setup Robot reliability on macOS systems where the PRC certificate is not already trusted.
What Changed
- Added automatic PRC root CA installation attempt during setup when the certificate is missing from the user login keychain.
- Added fallback trust loading from the bundled PRC root certificate.
- Added DER-to-PEM conversion for bundled certificate assets so gRPC can use them correctly as trust roots.
- Improved status diagnostics for certificate installation success or failure.
- Added better setup failure visibility via traceback/status reporting.
Why
Some users could start the embedded server but still fail setup with TLS handshake errors:
- CERTIFICATE_VERIFY_FAILED
- unable to get local issuer certificate
These changes reduce manual troubleshooting and improve first-run experience on fresh macOS machines.
User Impact
- On most macOS systems, setup now self-recovers by installing or using the bundled root CA.
- If auto-install cannot run due to permissions, users get a clear status message and can run the install command manually.
Manual Fallback (if needed)
Run from the Certificates folder:
security add-trusted-cert -r trustRoot -k ~/Library/Keychains/login.keychain-db ./PRCRootCertificate.crtThen restart Blender and run Setup Robot again.
Notes
- Existing users with a correctly trusted PRC CA are unaffected.
- This release focuses on trust chain and setup diagnostics only.