Skip to content
Terraform provisioner for rescue mode
Go Shell Makefile
Branch: master
Clone or download
Latest commit 8bfef4e May 27, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
rescue Add rescue provisoner Oct 3, 2018
scripts Add rescue provisoner Oct 3, 2018
vendor Revendor May 24, 2019
.gitignore Add rescue provisoner Oct 3, 2018
.lookout.yml Add rescue provisoner Oct 3, 2018
.travis.yml vendored in dependencies May 24, 2019
LICENSE Add licese Sep 28, 2018
Makefile Add rescue provisoner Oct 3, 2018
go.mod go mod tidy May 24, 2019
go.sum go mod tidy May 24, 2019
main.go Add rescue provisoner Oct 3, 2018

Terraform Provisioner for server rescue mode


  • Terraform 0.10.x
  • Go 1.8 (to build the provider plugin)

About The Provisioner

This provisioner is built to enable the rescue mode on a server and then execute actions to it via remote-exec when it is being created.
This can be used to for example format the disks or install a specific OS.

Building The Provisioner

Clone repository to: $GOPATH/src/

$ mkdir -p $GOPATH/src/; cd $GOPATH/src/
$ git clone

Enter the provider directory and build the provider

$ cd $GOPATH/src/
$ make build

Using the provisioner

resource "online_server" "dedibox" {
    provisioner "online-rescue" {
        "enabled" = true
        "server" = "${}"
        "image" = "ubuntu-18.04_amd64"
        "credentials_dir" = "/tmp/${}"

    // the following is a hack as provisioners can not output data
    connection {
        host = "${file("/tmp/${}/ip")}"
        type     = "ssh"
        user     = "${file("/tmp/${}/username")}"
        password = "${file("/tmp/${}/password")}"

    provisioner "remote-exec" {
        inline = [
        "mkfs.ext4 /dev/sda",

    provisioner "online-rescue" {
        "enabled" = true
        "server" = "${}"

Developing the Provisioner

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.8+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make build
$ $GOPATH/bin/terraform-provisioner-online-rescue

In order to test the provider, you can simply run make test.

$ make test

In order to run the full suite of Acceptance tests, run make testacc.

Note: Acceptance tests create real resources, and often cost money to run.

$ make testacc
You can’t perform that action at this time.