Changelog

odoo/documentation#17552

Created by ArjunR00T

Blocked

Merge method
Review
CI
- ci/documentation
- ci/codeowner_coverage

label: ArjunR00T:fix-timezone-troubleshooting
head: 7bef6d0448cbdc8dc07757bdb2cc6e90c9765560

	odoo/documentation
19.0	#17552 ^{missing statuses} ^{missing r+}
saas-19.1
saas-19.2
saas-19.3
master

Fix timezone troubleshooting

Description

This PR adds a troubleshooting tip to the on-premise source installation guide to address a common environment issue encountered by developers, particularly those using WSL in certain regions (e.g., India).

Problem

When running Odoo on WSL, PostgreSQL may fail to start the session if it doesn't recognize the timezone string passed by the host environment (e.g., psycopg2.errors.InvalidParameterValue: time zone "Asia/Calcutta" not recognized). This is often due to legacy timezone naming or missing tzdata in the Linux subsystem.

Solution

Added a generalized troubleshooting tip in the source.rst file that guides users to:
1. Update their system's tzdata.
2. Reconfigure the timezone to a modern, recognized standard (e.g., Asia/Kolkata).
3. Restart the PostgreSQL service.

This ensures a smoother onboarding experience for new developers setting up their local environments.

Tasks

[x] Verified the .rst formatting locally using make html.
[x] Confirmed the tip is placed in the relevant "Source Install" section.