Skip to content

tomkp/hetzner-tui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hetzner-tui

npm

An interactive terminal UI for managing Hetzner Cloud and DNS resources. Built with React and Ink for a modern terminal experience.

CleanShot 2026-01-15 at 09 55 03@2x

Looking for a CLI instead? Check out @tomkp/hetzner-cli

Installation

npm install -g @tomkp/hetzner-tui

This will make the hetzner command available globally.

From source

git clone https://github.com/tomkp/hetzner-tui.git
cd hetzner-tui
npm install
npm run build
npm link

Quick Start

hetzner

On first run, you'll be guided through a setup wizard to configure your API tokens.

Features

Resource Management

Browse and manage all your Hetzner Cloud resources:

  • Servers - View server status, power on/off, reboot
  • Volumes - View attached/detached volumes
  • Networks - View private networks and IP ranges
  • Firewalls - View firewall rules and applied resources
  • Floating IPs - View floating IP assignments
  • Load Balancers - View load balancer configuration
  • Certificates - View SSL/TLS certificates and status
  • Primary IPs - View primary IP assignments
  • Placement Groups - View server placement groups
  • SSH Keys - View registered SSH keys

DNS Management

Manage your Hetzner DNS zones and records:

  • DNS Zones - View all DNS zones and record counts
  • DNS Records - View all DNS records across zones

Settings

  • View and manage API token configuration
  • Clear settings and reconfigure

Configuration

API Tokens

The TUI requires API tokens to interact with Hetzner services:

  • Cloud API Token - For managing servers, volumes, networks, etc.
  • DNS API Token - For managing DNS zones and records (optional)

Get your tokens from:

Token Configuration

Tokens can be provided via:

  1. Environment variables:

    export HETZNER_TOKEN=<your-cloud-token>
    export HETZNER_DNS_TOKEN=<your-dns-token>
  2. Configuration file (via setup wizard or settings):

    • Stored in ~/.config/hetzner/config.json
    • Run the setup wizard: launch hetzner and select "Run Setup Wizard" from Settings

Navigation

Key Action
/ Navigate menu items
Enter Select item
Esc Go back / Exit
r Refresh current view
q Quit application

Screenshots

┌─────────────────────────────────────┐
│  Hetzner TUI                        │
│  Manage your Hetzner Cloud          │
├─────────────────────────────────────┤
│  → Servers                          │
│    Volumes                          │
│    Networks                         │
│    Firewalls                        │
│    Floating IPs                     │
│    Load Balancers                   │
│    ...                              │
├─────────────────────────────────────┤
│  ↑↓ Navigate  Enter Select  q Quit  │
└─────────────────────────────────────┘

Related

License

MIT

About

Interactive terminal UI for managing Hetzner Cloud and DNS resources

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors