Re: Creating first database

On Sat Mar 29, 2025 at 6:56 AM PDT, Tom Lane wrote:
> PG Doc comments form <noreply(at)postgresql(dot)org> writes:
>> In the Getting Started section of the documentation which would be used by a
>> new user immediately after installing PostgreSQL, the user is asked to run
>> $ createdb mydb
>> If the database is correctly installed, this first command to be run by the
>> new user inevitably fails with the error:
>> createdb: error: connection to server at "localhost" (::1), port 5432
>> failed: FATAL: password authentication failed for user "Mark"

> We can't really hope to document everything that every packager does
> in the community Postgres documentation, not least because they seldom
> inform us. I suppose it might be helpful to add something along the
> lines of "if you are using a pre-packaged version of Postgres, please
> consult the packager's documentation".

Given that the 'Installation' subsection, before the 'Creating a
Database' subsection within Getting Started, covers the various way
Postgres may be installed, and covers that environment variables may
need to be tweaked to accommodated the differences, I don't feel the
subsequent sections need to repeat how to deal with different types of
installations.

Best regards,
Gurjeet
https://Gurje.et