1. Packages
  2. Packages
  3. Talos Linux
  4. API Docs
  5. machine
  6. Bootstrap
Viewing docs for Talos v0.8.0
published on Wednesday, May 6, 2026 by Pulumiverse
Schema (JSON)
pulumiverse/pulumi-talos

talos.machine.Bootstrap

talos logo
Viewing docs for Talos v0.8.0
published on Wednesday, May 6, 2026 by Pulumiverse
Schema (JSON)
pulumiverse/pulumi-talos

    The machine bootstrap resource allows you to bootstrap a Talos node.

    Create Bootstrap Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Bootstrap(name: string, args: BootstrapArgs, opts?: CustomResourceOptions);
    @overload
def Bootstrap(resource_name: str,
              args: BootstrapArgs,
              opts: Optional[ResourceOptions] = None)

@overload
def Bootstrap(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              node: Optional[str] = None,
              client_configuration: Optional[ClientConfigurationArgs] = None,
              client_configuration_wo: Optional[BootstrapClientConfigurationWoArgs] = None,
              endpoint: Optional[str] = None,
              timeouts: Optional[BootstrapTimeoutsArgs] = None)
    func NewBootstrap(ctx *Context, name string, args BootstrapArgs, opts ...ResourceOption) (*Bootstrap, error)
    public Bootstrap(string name, BootstrapArgs args, CustomResourceOptions? opts = null)
    public Bootstrap(String name, BootstrapArgs args)
public Bootstrap(String name, BootstrapArgs args, CustomResourceOptions options)

    type: talos:machine:Bootstrap
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "talos_machine_bootstrap" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args BootstrapArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args BootstrapArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args BootstrapArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BootstrapArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BootstrapArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var bootstrapResource = new Talos.Machine.Bootstrap("bootstrapResource", new()
{
    Node = "string",
    ClientConfiguration = new Talos.Machine.Inputs.ClientConfigurationArgs
    {
        CaCertificate = "string",
        ClientCertificate = "string",
        ClientKey = "string",
    },
    ClientConfigurationWo = new Talos.Machine.Inputs.BootstrapClientConfigurationWoArgs
    {
        CaCertificate = "string",
        ClientCertificate = "string",
        ClientKey = "string",
    },
    Endpoint = "string",
    Timeouts = new Talos.Machine.Inputs.BootstrapTimeoutsArgs
    {
        Create = "string",
    },
});

    example, err := machine.NewBootstrap(ctx, "bootstrapResource", &machine.BootstrapArgs{
	Node: pulumi.String("string"),
	ClientConfiguration: &machine.ClientConfigurationArgs{
		CaCertificate:     pulumi.String("string"),
		ClientCertificate: pulumi.String("string"),
		ClientKey:         pulumi.String("string"),
	},
	ClientConfigurationWo: &machine.BootstrapClientConfigurationWoArgs{
		CaCertificate:     pulumi.String("string"),
		ClientCertificate: pulumi.String("string"),
		ClientKey:         pulumi.String("string"),
	},
	Endpoint: pulumi.String("string"),
	Timeouts: &machine.BootstrapTimeoutsArgs{
		Create: pulumi.String("string"),
	},
})

    resource "talos_machine_bootstrap" "bootstrapResource" {
  node = "string"
  client_configuration = {
    ca_certificate     = "string"
    client_certificate = "string"
    client_key         = "string"
  }
  client_configuration_wo = {
    ca_certificate     = "string"
    client_certificate = "string"
    client_key         = "string"
  }
  endpoint = "string"
  timeouts = {
    create = "string"
  }
}

    var bootstrapResource = new Bootstrap("bootstrapResource", BootstrapArgs.builder()
    .node("string")
    .clientConfiguration(ClientConfigurationArgs.builder()
        .caCertificate("string")
        .clientCertificate("string")
        .clientKey("string")
        .build())
    .clientConfigurationWo(BootstrapClientConfigurationWoArgs.builder()
        .caCertificate("string")
        .clientCertificate("string")
        .clientKey("string")
        .build())
    .endpoint("string")
    .timeouts(BootstrapTimeoutsArgs.builder()
        .create("string")
        .build())
    .build());

    bootstrap_resource = talos.machine.Bootstrap("bootstrapResource",
    node="string",
    client_configuration={
        "ca_certificate": "string",
        "client_certificate": "string",
        "client_key": "string",
    },
    client_configuration_wo={
        "ca_certificate": "string",
        "client_certificate": "string",
        "client_key": "string",
    },
    endpoint="string",
    timeouts={
        "create": "string",
    })

    const bootstrapResource = new talos.machine.Bootstrap("bootstrapResource", {
    node: "string",
    clientConfiguration: {
        caCertificate: "string",
        clientCertificate: "string",
        clientKey: "string",
    },
    clientConfigurationWo: {
        caCertificate: "string",
        clientCertificate: "string",
        clientKey: "string",
    },
    endpoint: "string",
    timeouts: {
        create: "string",
    },
});

    type: talos:machine:Bootstrap
properties:
    clientConfiguration:
        caCertificate: string
        clientCertificate: string
        clientKey: string
    clientConfigurationWo:
        caCertificate: string
        clientCertificate: string
        clientKey: string
    endpoint: string
    node: string
    timeouts:
        create: string

    Bootstrap Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Bootstrap resource accepts the following input properties:

    Node string
    The name of the node to bootstrap
    ClientConfiguration Pulumiverse.Talos.Machine.Inputs.ClientConfiguration
    The client configuration data
    ClientConfigurationWo Pulumiverse.Talos.Machine.Inputs.BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    Endpoint string
    The endpoint of the machine to bootstrap
    Timeouts Pulumiverse.Talos.Machine.Inputs.BootstrapTimeouts
    Node string
    The name of the node to bootstrap
    ClientConfiguration ClientConfigurationArgs
    The client configuration data
    ClientConfigurationWo BootstrapClientConfigurationWoArgs
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    Endpoint string
    The endpoint of the machine to bootstrap
    Timeouts BootstrapTimeoutsArgs
    node string
    The name of the node to bootstrap
    client_configuration object
    The client configuration data
    client_configuration_wo object
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint string
    The endpoint of the machine to bootstrap
    timeouts object
    node String
    The name of the node to bootstrap
    clientConfiguration ClientConfiguration
    The client configuration data
    clientConfigurationWo BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint String
    The endpoint of the machine to bootstrap
    timeouts BootstrapTimeouts
    node string
    The name of the node to bootstrap
    clientConfiguration ClientConfiguration
    The client configuration data
    clientConfigurationWo BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint string
    The endpoint of the machine to bootstrap
    timeouts BootstrapTimeouts
    node str
    The name of the node to bootstrap
    client_configuration ClientConfigurationArgs
    The client configuration data
    client_configuration_wo BootstrapClientConfigurationWoArgs
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint str
    The endpoint of the machine to bootstrap
    timeouts BootstrapTimeoutsArgs
    node String
    The name of the node to bootstrap
    clientConfiguration Property Map
    The client configuration data
    clientConfigurationWo Property Map
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint String
    The endpoint of the machine to bootstrap
    timeouts Property Map

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Bootstrap resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Bootstrap Resource

    Get an existing Bootstrap resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: BootstrapState, opts?: CustomResourceOptions): Bootstrap
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        client_configuration: Optional[ClientConfigurationArgs] = None,
        client_configuration_wo: Optional[BootstrapClientConfigurationWoArgs] = None,
        endpoint: Optional[str] = None,
        node: Optional[str] = None,
        timeouts: Optional[BootstrapTimeoutsArgs] = None) -> Bootstrap
    func GetBootstrap(ctx *Context, name string, id IDInput, state *BootstrapState, opts ...ResourceOption) (*Bootstrap, error)
    public static Bootstrap Get(string name, Input<string> id, BootstrapState? state, CustomResourceOptions? opts = null)
    public static Bootstrap get(String name, Output<String> id, BootstrapState state, CustomResourceOptions options)
    resources:  _:    type: talos:machine:Bootstrap    get:      id: ${id}
    import {
  to = talos_machine_bootstrap.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ClientConfiguration Pulumiverse.Talos.Machine.Inputs.ClientConfiguration
    The client configuration data
    ClientConfigurationWo Pulumiverse.Talos.Machine.Inputs.BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    Endpoint string
    The endpoint of the machine to bootstrap
    Node string
    The name of the node to bootstrap
    Timeouts Pulumiverse.Talos.Machine.Inputs.BootstrapTimeouts
    ClientConfiguration ClientConfigurationArgs
    The client configuration data
    ClientConfigurationWo BootstrapClientConfigurationWoArgs
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    Endpoint string
    The endpoint of the machine to bootstrap
    Node string
    The name of the node to bootstrap
    Timeouts BootstrapTimeoutsArgs
    client_configuration object
    The client configuration data
    client_configuration_wo object
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint string
    The endpoint of the machine to bootstrap
    node string
    The name of the node to bootstrap
    timeouts object
    clientConfiguration ClientConfiguration
    The client configuration data
    clientConfigurationWo BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint String
    The endpoint of the machine to bootstrap
    node String
    The name of the node to bootstrap
    timeouts BootstrapTimeouts
    clientConfiguration ClientConfiguration
    The client configuration data
    clientConfigurationWo BootstrapClientConfigurationWo
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint string
    The endpoint of the machine to bootstrap
    node string
    The name of the node to bootstrap
    timeouts BootstrapTimeouts
    client_configuration ClientConfigurationArgs
    The client configuration data
    client_configuration_wo BootstrapClientConfigurationWoArgs
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint str
    The endpoint of the machine to bootstrap
    node str
    The name of the node to bootstrap
    timeouts BootstrapTimeoutsArgs
    clientConfiguration Property Map
    The client configuration data
    clientConfigurationWo Property Map
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client configuration data (write-only). Use this instead of clientConfiguration when using ephemeral resources. Requires Terraform 1.11+
    endpoint String
    The endpoint of the machine to bootstrap
    node String
    The name of the node to bootstrap
    timeouts Property Map

    Supporting Types

    BootstrapClientConfigurationWo, BootstrapClientConfigurationWoArgs

    CaCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    ClientCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    ClientKey string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    CaCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    ClientCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    ClientKey string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    ca_certificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    client_certificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    client_key string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    caCertificate String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    clientCertificate String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    clientKey String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    caCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    clientCertificate string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    clientKey string
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    ca_certificate str
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    client_certificate str
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    client_key str
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key
    caCertificate String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client CA certificate
    clientCertificate String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client certificate
    clientKey String
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. The client key

    BootstrapTimeouts, BootstrapTimeoutsArgs

    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

    ClientConfiguration, ClientConfigurationArgs

    A Client Configuration
    CaCertificate string
    The client CA certificate
    ClientCertificate string
    The client certificate
    ClientKey string
    The client private key
    CaCertificate string
    The client CA certificate
    ClientCertificate string
    The client certificate
    ClientKey string
    The client private key
    ca_certificate string
    The client CA certificate
    client_certificate string
    The client certificate
    client_key string
    The client private key
    caCertificate String
    The client CA certificate
    clientCertificate String
    The client certificate
    clientKey String
    The client private key
    caCertificate string
    The client CA certificate
    clientCertificate string
    The client certificate
    clientKey string
    The client private key
    ca_certificate str
    The client CA certificate
    client_certificate str
    The client certificate
    client_key str
    The client private key
    caCertificate String
    The client CA certificate
    clientCertificate String
    The client certificate
    clientKey String
    The client private key

    Package Details

    Repository
    talos pulumiverse/pulumi-talos
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the talos Terraform Provider.
    talos logo
    Viewing docs for Talos v0.8.0
    published on Wednesday, May 6, 2026 by Pulumiverse
    Schema (JSON)
    pulumiverse/pulumi-talos
      Try Pulumi Cloud free. Your team will thank you.