Skip to main content

Introduction

Create an EVE-OS installer image with SSH pre-enabled to connect to a node via SSH before onboarding it to Edge Infrastructure Services. Use this approach when you need to troubleshoot hardware or validate network connectivity before completing onboarding. After you onboard the node, the pre-configured SSH key is erased. To re-enable SSH access after onboarding, use the ZCLI debug.enable.ssh configuration property.

Prerequisites

  • Docker is installed and running on your local machine.

Get Your SSH Key

  1. Check whether you already have an SSH key.
  1. If the output is blank, generate a new SSH key.
  1. Copy your SSH public key. You will add it to the image configuration in the next step.

Add the Custom Configuration

  1. Create a directory for your configuration files.
  1. Add your SSH public key to a file named authorized_keys. Replace PUBLIC_KEY_PATH with the path to your public key file (typically ~/.ssh/id_rsa.pub).
  1. Write your cluster hostname to a file named server. Replace the hostname with your actual cluster endpoint.
  1. Create a global.json file that enables SSH access.

Generate the SSH-Enabled Installer

Generate the installer image. Replace latest with the specific EVE-OS version tag appropriate for your deployment.

Connect to Your Node via SSH

After installing EVE-OS from this image, connect to the node using your SSH private key. Replace YOUR_PRIVATE_KEY_PATH (typically ~/.ssh/id_rsa) and DEVICE_IP with the appropriate values.

Next Steps

Flash an EVE-OS Installer or Live Image

Write the installer-ssh.raw to a USB drive.

Install EVE-OS onto an Edge Device

Install from the flashed USB drive.

Onboard Nodes

Complete onboarding after installation.