{
    "mode": "man",
    "parameter": "user_clusters",
    "section": "5",
    "url": "https://www.chedong.com/phpMan.php/man/user_clusters/5/json",
    "generated": "2026-06-02T18:13:57Z",
    "sections": {
        "NAME": {
            "content": "userclusters - File linking users to PostgreSQL clusters\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The  file  /etc/postgresql-common/userclusters  maps  users against the database clusters to\nwhich they will connect by default. However,  every  user  can  override  these  settings  in\n~/.postgresqlrc.\n\nWhen  scanning this file, the first matching line will be used.  It is a good idea to provide\na default explicitly, with a final line where both user and group are set to *.\n\nIf there is no default, the implicit default is to connect to the cluster listening  on  port\n5432 and to the database matching the user's login name.\n\n",
            "subsections": []
        },
        "FORMAT": {
            "content": "Comments  are  introduced  by the character #.  Comments may follow data on a line; the first\ncomment character terminates the data. Leading whitespace and blank lines are ignored.\n\nEach uncommented, non-blank line must describe a user, group or the default (where both  user\nand group are set to *).\n\nFields must be given in the following order, separated by white space:\n\n\nUSER   The  login  id  of  the  Unix user to whom this line applies. The wildcard character *\nmeans any user.\n\nGROUP  The group name of the Unix group to which this line applies. The wildcard character  *\nmeans any group.\n\nVERSION\nThe major PostgreSQL version of the cluster to connect to.\n\nCLUSTER\nThe  name of a cluster to connect to. A remote cluster is specified with host:port. If\nport is empty, it defaults to 5432.\n\nDATABASE\nWithin the cluster, the database to which the user will connect by default if he  does\nnot  specify  a database on the command line.  If this is *, the default database will\nbe the one named by the user's login id.\n\n",
            "subsections": []
        },
        "NOTES": {
            "content": "Since the first matching line is used, the default line must come last.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "pgwrapper(1), postgresqlrc(5)\n\n\n\nDebian                                      Feburary 2005                           USERCLUSTERS(5)",
            "subsections": []
        }
    },
    "summary": "userclusters - File linking users to PostgreSQL clusters",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "pgwrapper",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pgwrapper/1/json"
        },
        {
            "name": "postgresqlrc",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/postgresqlrc/5/json"
        }
    ]
}