Skip to content

Commit 15784d0

Browse files
committed
Document PowerOffOnError for self-hosted
1 parent c01a9e8 commit 15784d0

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

docs/concepts/worker-pools.md

+11
Original file line numberDiff line numberDiff line change
@@ -272,6 +272,17 @@ If for some reason this causes problems, you can run the launcher as `root` by s
272272
!!! tip
273273
Versions v0.0.7 or older of Self-Hosted always ran the launcher as root. In newer versions this behavior has changed to default to the `spacelift` user.
274274

275+
#### PowerOffOnError
276+
277+
By default, the startup script for the EC2 instances automatically terminates the instance if the launcher exits. This is to allow the instance to be automatically removed from the autoscale group and a new one added in the case of errors.
278+
279+
Sometimes it can be useful to disable this behavior, for example if instances are repeatedly crashing on startup, preventing you from being able to connect to investigate any issues before they terminate.
280+
281+
To do this, set the `PowerOffOnError` setting to false when deploying your CloudFormation stack.
282+
283+
!!! info
284+
Please note, if you update this setting on an existing CloudFormation stack, you will need to restart all the workers in the pool before the updated setting takes effect.
285+
275286
#### Deploying the Template
276287

277288
To deploy your worker pool stack, you can use the following command:

0 commit comments

Comments
 (0)