CREATEDB(1)              PostgreSQL 18.6 Documentation             CREATEDB(1)

<?><?><?> (NAME)
       createdb - <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> PostgreSQL

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       createdb [connection-option...] [option...] [dbname [description]]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> createdb <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> PostgreSQL <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> -O <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?>.

       <?><?><?><?><?> createdb <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> SQL <?><?> <?><?><?> CREATE DATABASE <?><?><?>. <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?> createdb <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>:

       dbname
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> PostgreSQL
           <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       description
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       -D tablespace
       --tablespace=tablespace
           <?><?><?><?> <?><?><?><?> (tablespace) <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. (<?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.)

       -e
       --echo
           <?><?><?><?><?><?><?><?> <?><?> <?><?> createdb <?><?><?><?><?>
           <?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (echo).

       -E encoding
       --encoding=encoding
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (character
           encoding scheme) <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           PostgreSQL <?><?> <?><?><?> 23.3.1 <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>.

       -l locale
       --locale=locale
           <?><?><?><?><?> (locale) <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           --lc-collate<?> --lc-ctype <?> --icu-locale <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> ICU
           <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?> <?><?>
           --icu-locale <?><?><?><?><?> <?><?><?><?>.

       --lc-collate=locale
           <?><?><?><?><?> LC_COLLATE <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --lc-ctype=locale
           <?><?><?><?><?> LC_CTYPE <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       --builtin-locale=locale
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> (builtin) <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?> 23.1 <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

       --icu-locale=locale
           <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> ICU<?>
           <?><?><?><?><?> <?><?><?><?><?> ICU <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --icu-rules=rules
           <?><?><?><?><?> <?><?><?><?><?> (collation rules) <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> ICU <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --locale-provider={builtin|libc|icu}
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -O owner
       --owner=owner
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
           (<?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.)

       -S strategy
       --strategy=strategy
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> CREATE DATABASE STRATEGY
           <?><?><?><?><?><?> <?><?><?><?>.

       -T template
       --template=template
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>. (<?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.)

       -V
       --version
           <?><?><?><?> createdb <?><?> <?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?><?><?>.

       -?
       --help
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> createdb <?><?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> -D<?> -l<?> -E<?> -O <?> -T
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       SQL <?><?><?><?><?><?><?><?> CREATE DATABASE <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> createdb <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:

       -h host
       --host=host
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> (Unix domain socket)
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -p port
       --port=port
           <?><?><?><?> TCP <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       -U username
       --username=username
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?>.

       -w
       --no-password
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           .pgpass <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           (batch jobs) <?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?>.

       -W
       --password
           <?><?><?><?><?><?> createdb <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> createdb <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?>
           <?><?><?><?><?> createdb <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?>. <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> -W <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?>.

       --maintenance-db=dbname
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
           postgres <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>)<?>
           <?><?> template1 <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> (connection string) <?><?><?><?>.
           <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       PGDATABASE
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.

       PGHOST
       PGPORT
       PGUSER
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>.  PGUSER <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> PGDATABASE
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       PG_COLOR
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           always<?> auto <?> never.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> PostgreSQL<?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> libpq <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?> <?><?><?> 32.15
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?> (DIAGNOSTICS)
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> CREATE DATABASE
       (CREATE_DATABASE(7)) <?> psql(1) <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> libpq <?><?><?><?><?> <?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> demo <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

           $ createdb demo

       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> demo
       <?><?><?> <?><?><?><?><?><?> eden<?> <?><?><?><?> 5000<?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> template0<?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?> SQL <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?> <?><?><?> <?><?><?>:

           $ createdb -p 5000 -h eden -T template0 -e demo
           CREATE DATABASE demo TEMPLATE template0;

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       dropdb(1), CREATE DATABASE (CREATE_DATABASE(7))

PostgreSQL 18.6                      2026                          CREATEDB(1)