---
layout: "cobbler"
page_title: "Cobbler: cobbler_system"
sidebar_current: "docs-cobbler-resource-system"
description: |-
  Manages a System within Cobbler.
---

# cobbler\_system

Manages a System within Cobbler.

## Example Usage

```
resource "cobbler_system" "my_system" {
  name = "my_system"
  profile = "${cobbler_profile.my_profile.name}"
  name_servers = ["8.8.8.8", "8.8.4.4"]
  comment = "I'm a system"

  interface {
    name = "eth0"
    mac_address = "aa:bb:cc:dd:ee:ff"
    static = true
    ip_address = "1.2.3.4"
    netmask = "255.255.255.0"
  }

  interface {
    name = "eth1"
    mac_address = "aa:bb:cc:dd:ee:fa"
    static = true
    ip_address = "1.2.3.5"
    netmask = "255.255.255.0"
  }
}
```

## Argument Reference

The following arguments are supported:

* `boot_files` - (Optional) TFTP boot files copied into tftpboot.

* `comment` - (Optional) Free form text description

* `enable_gpxe` - (Optional) Use gPXE instead of PXELINUX.

* `fetchable_files` - (Optional) Templates for tftp or wget.

* `gateway` - (Optional) Network gateway.

* `hostname` - (Optional) Hostname of the system.

* `image` - (Optional) Parent image (if no profile is used).

* `interface` - (Optional)

* `ipv6_default_device` - (Optional) IPv6 default device.

* `kernel_options` - (Optional) Kernel options.
  ex: selinux=permissive.

* `kernel_options_post` - (Optional) Kernel options (post install).

* `kickstart` - (Optional) Path to kickstart template.

* `ks_meta` - (Optional) Kickstart metadata.

* `ldap_enabled` - (Optional) Configure LDAP at next config update.

* `ldap_type` - (Optional) LDAP management type.

* `mgmt_classes` - (Optional) Management classes for external config
  management.
* `mgmt_parameters` - (Optional) Parameters which will be handed to
  your management application. Must be a valid YAML dictionary.

* `monit_enabled` - (Optional) Configure monit on this machine at
  next config update.

* `name_servers_search` - (Optional) Name servers search path.

* `name_servers` - (Optional) Name servers.

* `name` - (Required) The name of the system.

* `netboot_enabled` - (Optional) (re)Install this machine at next
  boot.

* `owners` - (Optional) Owners list for authz_ownership.

* `power_address` - (Optional) Power management address.

* `power_id` - (Optional) Usually a plug number or blade name if
  power type requires it.

* `power_pass` - (Optional) Power management password.

* `power_type` - (Optional) Power management type.

* `power_user` - (Optional) Power management user.

* `profile` - (Required) Parent profile.

* `proxy` - (Optional) Proxy URL.

* `redhat_management_key` - (Optional) Red Hat management key.

* `redhat_management_server` - (Optional) Red Hat management server.

* `status` - (Optional) System status (development, testing,
  acceptance, production).

* `template_files` - (Optional) File mappings for built-in
  configuration management.

* `template_remote_kickstarts` - (Optional) template remote
  kickstarts.

* `virt_auto_boot` - (Optional) Auto boot the VM.

* `virt_cpus` - (Optional) Number of virtual CPUs in the VM.

* `virt_disk_driver` - (Optional) The on-disk format for the
  virtualization disk.

* `virt_file_size` - (Optional) Virt file size.

* `virt_path` - (Optional) Path to the VM.

* `virt_pxe_boot` - (Optional) Use PXE to build this VM?

* `virt_ram` - (Optional) The amount of RAM for the VM.

* `virt_type` - (Optional) Virtualization technology to use: xenpv,
  xenfv, qemu, kvm, vmware, openvz.

The `interface` block supports:

* `name` - (Required) The device name of the interface. ex: eth0.

* `cnames` - (Optional) Canonical name records.

* `dhcp_tag` - (Optional) DHCP tag.

* `dns_name` - (Optional) DNS name.

* `bonding_opts` - (Optional) Options for bonded interfaces.

* `bridge_opts` - (Optional) Options for bridge interfaces.

* `gateway` - (Optional) Per-interface gateway.

* `interface_type` - (Optional) The type of interface: na, master,
  slave, bond, bond_slave, bridge, bridge_slave, bonded_bridge_slave.

* `interface_master` - (Optional) The master interface when slave.

* `ip_address` - (Optional) The IP address of the interface.

* `ipv6_address` - (Optional) The IPv6 address of the interface.

* `ipv6_mtu` - (Optional) The MTU of the IPv6 adress.

* `ipv6_static_routes` - (Optional) Static routes for the IPv6
  interface.

* `ipv6_default_gateway` - (Optional) The default gateawy for the
  IPv6 address / interface.

* `mac_address` - (Optional) The MAC address of the interface.

* `management` - (Optional) Whether this interface is a management
  interface.

* `netmask` - (Optional) The IPv4 netmask of the interface.

* `static` - (Optional) Whether the interface should be static or
  DHCP.

* `static_routes` - (Optional) Static routes for the interface.

* `virt_bridge` - (Optional) The virtual bridge to attach to.

## Attribute Reference

All optional attributes listed above are also exported.