{
    "mode": "man",
    "parameter": "systemd-getty-generator",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/systemd-getty-generator/8/json",
    "generated": "2026-11-21T20:29:20Z",
    "synopsis": "/usr/lib/systemd/system-generators/systemd-getty-generator",
    "sections": {
        "NAME": {
            "content": "systemd-getty-generator - Generator for enabling getty instances on the console\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "/usr/lib/systemd/system-generators/systemd-getty-generator\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "systemd-getty-generator is a generator that automatically instantiates serial-getty@.service\non the kernel consoles, if they can function as ttys and are not provided by the virtual\nconsole subsystem. It will also instantiate serial-getty@.service instances for virtualizer\nconsoles, if execution in a virtualized environment is detected. If execution in a container\nenvironment is detected, it will instead enable console-getty.service for /dev/console, and\ncontainer-getty@.service instances for additional container pseudo TTYs as requested by the\ncontainer manager (see Container Interface[1]). This should ensure that the user is shown a\nlogin prompt at the right place, regardless of which environment the system is started in.\nFor example, it is sufficient to redirect the kernel console with a kernel command line\nargument such as console= to get both kernel messages and a getty prompt on a serial TTY. See\nThe kernel's command-line parameters[2] for more information on the console= kernel\nparameter.\n\nsystemd-getty-generator implements systemd.generator(7).\n\nFurther information about configuration of gettys can be found in systemd for Administrators,\nPart XVI: Gettys on Serial Consoles (and Elsewhere)[3].\n",
            "subsections": []
        },
        "KERNEL COMMAND LINE": {
            "content": "systemd-getty-generator understands the following kernel-command-line(7) parameters:\n\nsystemd.gettyauto=\nthis options take an optional boolean argument, and default to yes. The generator is\nenabled by default, and a false value may be used to disable it.\n\nAdded in version 250.\n",
            "subsections": []
        },
        "ENVIRONMENT": {
            "content": "$SYSTEMDGETTYAUTO\nThis variable takes an optional boolean argument, and default to yes. The generator is\nenabled by default, and a false value may be used to disable it.\n\nAdded in version 250.\n",
            "subsections": []
        },
        "SYSTEM CREDENTIALS": {
            "content": "getty.ttys.serial, getty.ttys.container\nThese system credentials may be used to spawn additional login prompts on selected TTYs.\nThe two credentials should contain a newline-separated list of TTY names to spawn\ninstances of serial-getty@.service (in case of getty.ttys.serial) and\ncontainer-getty@.service (in case of getty.ttys.container) on.\n\nAdded in version 254.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "systemd(1), kernel-command-line(7), systemd.system-credentials(7), agetty(8)\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. Container\nInterface\nhttps://systemd.io/CONTAINERINTERFACE\n\n2. The kernel's command-line parameters\nhttps://docs.kernel.org/admin-guide/kernel-parameters.html\n\n3. systemd for Administrators, Part XVI: Gettys on Serial Consoles (and Elsewhere)\nhttps://0pointer.de/blog/projects/serial-console.html\n\nsystemd 255                                                               SYSTEMD-GETTY-GENERATOR(8)",
            "subsections": []
        }
    },
    "summary": "systemd-getty-generator - Generator for enabling getty instances on the console",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "systemd",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/systemd/1/json"
        },
        {
            "name": "kernel-command-line",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/kernel-command-line/7/json"
        },
        {
            "name": "systemd.system-credentials",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/systemd.system-credentials/7/json"
        },
        {
            "name": "agetty",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/agetty/8/json"
        }
    ]
}