Skip to content

Quick Start Guide

This document will guide you through installing and configuring Digital Rebar. It will also walk through provisioning a guest OS using Digital Rebar. For this guide we are going to show a basic virtual environment where all systems, including the digital rebar instance reside on the same virtual server and network.

TL;DR - From linux prompt as root

curl -fsSL get.rebar.digital/stable | bash -s -- install --universal

We also recommend consulting the video guide of this process. Other helpful videos are available including our advanced features showcase (Uses cookies).

Prerequisites

Digital Rebar Platform (DRP) resources (Machines in DRP parlance) can run on physical, virtual, cloud, or container instances. All instances should have at least the following minimum requirements.

This guide will configure Digital Rebar to use systemd to control the service.

This graphic shows the basic layout for the quick start system example:

Basic layout for a Digital Rebar Quick Start

Hardware

  • 1 or more CPU cores
  • A minimun of 4 GB of memory
  • A minimum of 20 GB of space (60 GB is recommended)

Operating Systems

  • Linux (Centos 8 is recommended)
  • MacOS

Software

The following packages are needed for installation.

  • bash
  • curl
  • tar
  • sha256sum (linux), shasum (MacOS)

Network

Most Digital Rebar environments require detailed knowledge of your network and DHCP environments.

Digital Rebar provides dhcp by default on all interfaces where the endpoint is running. It is important that any other service that provides dhcp on the endpoint should be disabled.

All hosts in the subnet should communicate to the DRP instance using the ports listed in the ports link.

Guest VMs

  • 1 or more virtual CPU cores
  • A minimum of 2 GB of memory (4 is recommended)
  • A minimum of 10 GB of space

Install Digital Rebar Endpoint

Run the following command in a shell or terminal:

curl -fsSL get.rebar.digital/stable | bash -s -- install --universal

The command will download the stable version of Digital Rebar, and content bundles needed to support Universal workflows. It then extracts files, verifies prerequisites are installed, and creates the needed directories and links under /var/lib/dr-provision.

The install script has many additional options that are documented in the --help output and explored in other install guides. You can output the help text with the following command:

curl -fsSL get.rebar.digital/stable | bash -s -- --help

Once the installation script completes, a Digital Rebar endpoint will be running your local system.

At this point, you should finish configuration and continue post-install setup.