Skip to content

docs: Document host OS customization & scripting options #2444

@benhuntley

Description

@benhuntley

How would you describe the priority of this documentation request

Medium

Describe the future/missing documentation

Gap: A customer asked "what are the OS customization and scripting options with NICo?" and couldn't find the answer. The capabilities exist but aren't documented as a set: PXE serves cloud-init user-data and iPXE scripts, the instance-create API exposes userData / ipxeScript / sshKeys, and "any OS installable via iPXE" is supported — but there's no consolidated section, and SSH-key injection, custom OS-image delivery, and post-install/first-boot scripting are undocumented.

Raised by: Lenovo (NICo follow-up).

Docs needed — a single "OS customization & scripting" section covering:

  • cloud-init / userData, custom ipxeScript, and sshKeys (with the instance-create fields).
  • How to provide a custom OS image.
  • Any supported post-install / first-boot scripting or run-commands.

Code of Conduct

  • I agree to follow this project's Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status
    Triage

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions