# SystemdConfigFileOptions

Options for creating a SystemD configuration file.

- Source: [`aws-ec2/lib/cfn-init-elements.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-ec2/lib/cfn-init-elements.ts#L1071)
- Type last changed: v2.140.0 · 2 May 2024

## Example

TypeScript:

```ts
declare const vpc: ec2.Vpc;
declare const instanceType: ec2.InstanceType;

new ec2.Instance(this, 'Instance', {
  vpc,
  instanceType,
  machineImage: ec2.MachineImage.latestAmazonLinux2023(),

  init: ec2.CloudFormationInit.fromElements(
    // Create a simple config file that runs a Python web server
    ec2.InitService.systemdConfigFile('simpleserver', {
      command: '/usr/bin/python3 -m http.server 8080',
      cwd: '/var/www/html',
    }),
    // Start the server using SystemD
    ec2.InitService.enable('simpleserver', {
      serviceManager: ec2.ServiceManager.SYSTEMD,
    }),
    // Drop an example file to show the web server working
    ec2.InitFile.fromString('/var/www/html/index.html', 'Hello! It\'s working!'),
  ),
});
```

Python:

```python
# vpc: ec2.Vpc
# instance_type: ec2.InstanceType

ec2.Instance(self, "Instance",
    vpc=vpc,
    instance_type=instance_type,
    machine_image=ec2.MachineImage.latest_amazon_linux2023(),

    init=ec2.CloudFormationInit.from_elements(
        # Create a simple config file that runs a Python web server
        ec2.InitService.systemd_config_file("simpleserver",
            command="/usr/bin/python3 -m http.server 8080",
            cwd="/var/www/html"
        ),
        # Start the server using SystemD
        ec2.InitService.enable("simpleserver",
            service_manager=ec2.ServiceManager.SYSTEMD
        ),
        # Drop an example file to show the web server working
        ec2.InitFile.from_string("/var/www/html/index.html", "Hello! It's working!"))
)
```

Java:

```java
Vpc vpc;
InstanceType instanceType;

Instance.Builder.create(this, "Instance")
        .vpc(vpc)
        .instanceType(instanceType)
        .machineImage(MachineImage.latestAmazonLinux2023())

        .init(CloudFormationInit.fromElements(InitService.systemdConfigFile("simpleserver", SystemdConfigFileOptions.builder()
                .command("/usr/bin/python3 -m http.server 8080")
                .cwd("/var/www/html")
                .build()), InitService.enable("simpleserver", InitServiceOptions.builder()
                .serviceManager(ServiceManager.SYSTEMD)
                .build()), InitFile.fromString("/var/www/html/index.html", "Hello! It's working!")))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
Vpc vpc;
InstanceType instanceType;

new Instance(this, "Instance", new InstanceProps {
    Vpc = vpc,
    InstanceType = instanceType,
    MachineImage = MachineImage.LatestAmazonLinux2023(),

    Init = CloudFormationInit.FromElements(InitService.SystemdConfigFile("simpleserver", new SystemdConfigFileOptions {
        Command = "/usr/bin/python3 -m http.server 8080",
        Cwd = "/var/www/html"
    }), InitService.Enable("simpleserver", new InitServiceOptions {
        ServiceManager = ServiceManager.SYSTEMD
    }), InitFile.FromString("/var/www/html/index.html", "Hello! It's working!"))
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var vpc Vpc
var instanceType InstanceType

ec2.NewInstance(this, jsii.String("Instance"), &InstanceProps{
	Vpc: Vpc,
	InstanceType: InstanceType,
	MachineImage: ec2.MachineImage_LatestAmazonLinux2023(),

	Init: ec2.CloudFormationInit_FromElements(ec2.InitService_SystemdConfigFile(jsii.String("simpleserver"), &SystemdConfigFileOptions{
		Command: jsii.String("/usr/bin/python3 -m http.server 8080"),
		Cwd: jsii.String("/var/www/html"),
	}), ec2.InitService_Enable(jsii.String("simpleserver"), &InitServiceOptions{
		ServiceManager: ec2.ServiceManager_SYSTEMD,
	}), ec2.InitFile_FromString(jsii.String("/var/www/html/index.html"), jsii.String("Hello! It's working!"))),
})
```

## Properties

- `afterNetwork`: boolean = true — Start the service after the networking part of the OS comes up.

- `command`: string (required) — The command to run to start this service.

- `cwd`: string — The working directory for the command.

  **Default:** Root directory or home directory of specified user

- `description`: string — A description of this service.

  **Default:** No description

- `environmentFiles`: string[] — Loads environment variables from files when the process is running.

  **Default:** No environment files

  Must use absolute paths.

- `environmentVariables`: { [key: string]: string } — Environment variables to load when the process is running.

  **Default:** No environment variables set

- `group`: string = root — The group to execute the process under.

- `keepRunning`: boolean = true — Keep the process running all the time.

  Restarts the process when it exits for any reason other
  than the machine shutting down.

- `user`: string = root — The user to execute the process under.
