Skip to content

Storage HostPath

Storage HostPath

Category: Storage Type: Cluster Service Tags: storage · hostpath · persistent-volume

Overview

The Storage HostPath plugin mounts an existing directory from a cluster node's filesystem as a Kubernetes Persistent Volume. This enables workloads to access directories that already exist on the host node — useful for integrating legacy tools managed by Ansible, exposing pre-existing datasets, or reusing directories that are already populated via NFS mounts or local disk on the node.

Security Warning: HostPath volumes give Pods direct access to the host node's filesystem. This can pose security risks if Pods are permitted to write to sensitive directories. Restrict access appropriately and ensure only trusted workloads can request HostPath-backed volumes.

How It Works

Cluster Service — Installed once per cluster by an administrator. Creates a shared storage volume backed by a directory on the host node, available to workloads across all projects.

Prerequisites

  • The specified host path must exist on all nodes that may schedule the workload using this volume (HostPath volumes are node-local and not replicated)
  • Appropriate file permissions on the host path for the user(s) running the workloads

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Storage HostPath"
  3. Click Install
  4. Fill in the configuration fields below
  5. Click Confirm to deploy

Configuration

Install-Time Fields

Field Details
path string · Required
Absolute path on the host node to expose as a Persistent Volume (e.g. /data/shared)
size string · Required · Default: 10Gi
Advertised size of the Persistent Volume. This is for scheduling purposes only and does not limit actual disk usage.

Notes

  • HostPath volumes are node-local — if a workload is rescheduled to a different node, it will not have access to the same data unless the path exists and is populated on that node as well
  • The size field is for Kubernetes scheduling metadata only; the actual available space depends on the host node's disk capacity
  • For production multi-node environments, consider using Storage NFS or Storage iSCSI instead, which provide storage accessible from any node
plugins/storage-hostpath/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
resource_id: storage-hostpath
name: Storage HostPath
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/storage-hostpath/scripts/assets/logo.png
description: | 
  Mount a location on the host node as a Persistent Volume in your Kubernetes cluster using the HostPath volume type.
  This plugin allows for operators to mount existing directories on the hosts into running Pods which means you can 
  reuse existing legacy tools such as Ansible. It is important to note that HostPath volumes are only local to the node, 
  so if you need access to a tool or library, you must ensure that all target nodes have this path available.

  **Warning:** Using HostPath volumes can pose security risks, as they allow Pods to access and modify files on the host node. 
  Ensure that you understand the implications and restrict access appropriately.
category: storage
tags:
  - storage
  - hostpath
  - persistent-volume
  - cluster-level
fields:
  - name: path
    description: Path on the host node to mount into the Persistent Volume
    required: true
  - name: size
    description: Size of the Persistent Volume to create (e.g., 10Gi). This is for scheduling purposes only.
    required: true
    default: 10Gi