mirror of
https://github.com/hashicorp/vault.git
synced 2025-08-22 15:11:07 +02:00
0660ea6fac
* Update README Let contributors know that docs will now be located in UDR * Add comments to each mdx doc Comment has been added to all mdx docs that are not partials * chore: added changelog changelog check failure * wip: removed changelog * Fix content errors * Doc spacing * Update website/content/docs/deploy/kubernetes/vso/helm.mdx Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> --------- Co-authored-by: jonathanfrappier <92055993+jonathanfrappier@users.noreply.github.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
66 lines
3.2 KiB
Plaintext
66 lines
3.2 KiB
Plaintext
---
|
||
layout: docs
|
||
page_title: CLI emulation in the Vault GUI
|
||
description: >-
|
||
Run basic Vault CLI commands in your Vault web UI with a REPL terminal.
|
||
---
|
||
|
||
> [!IMPORTANT]
|
||
> **Documentation Update:** Product documentation, which were located in this repository under `/website`, are now located in [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs), colocated with all other product documentation. Contributions to this content should be done in the `web-unified-docs` repo, and not this one. Changes made to `/website` content in this repo will not be reflected on the developer.hashicorp.com website.
|
||
|
||
# CLI emulation in the Vault GUI
|
||
|
||
The Vault GUI includes an advanced mode that uses a read–eval–print loop (REPL)
|
||
terminal to mimic basic create/read/update/delete/list (CRUDL) commands for
|
||
users who are more familiar with the Vault CLI than the GUI.
|
||
|
||
<Note title="Limited emulation">
|
||
|
||
The Vault Web REPL terminal **is not** a full terminal emulator. You cannot
|
||
use typical `bash` elements like environment variables, HEREDOC, or data/file
|
||
piping unless explicitly stated otherwise.
|
||
|
||
</Note>
|
||
|
||
## Command history
|
||
|
||
The Web REPL keeps a history of all commands your enter during the current
|
||
session. Refreshing the browser window and using the `clearall` command resets
|
||
your command history.
|
||
|
||
Use the up and down arrows while the REPL prompt has focus to cycle through the
|
||
command history. Fully cycling backward, past the start of the history, wraps
|
||
around to the most recent command. Cycling forward past the most recent command
|
||
stops at an empty prompt.
|
||
|
||
## Supported commands
|
||
|
||
<Tip>
|
||
|
||
The Web REPL terminal accepts commands with, or without, the `vault` prefix to
|
||
ensure example commands from the Vault documentation work when pasted into
|
||
the Web REPL terminal.
|
||
|
||
</Tip>
|
||
|
||
## Supported Vault CLI commands
|
||
|
||
REPL command | Associated CLI command | REPL differences
|
||
------------ | --------------------------------------- | ----------------------
|
||
`delete` | [`delete`](/vault/docs/commands/delete) | None
|
||
`list` | [`list`](/vault/docs/commands/list) | Issues GET requests with the `?list=true` query parameter rather than `LIST` requests
|
||
`read` | [`read`](/vault/docs/commands/read) | None
|
||
`write` | [`write`](/vault/docs/commands/write) | Does not support `@` syntax to set parameters and actions that require data structures as input are not supported
|
||
`kv-get` | [`kv get`](/vault/docs/commands/kv/get) | Only supports path syntax and KVv2 plugins, supports the `-metatdata` flag as shorthand for `-field=metadata`
|
||
|
||
## REPL-specific commands
|
||
|
||
Command | Description
|
||
------------ | -----------
|
||
`api` | Opens the interactive OpenAPI explorer in the Vault UI with information for all endpoints you can use with your current permissions
|
||
`clear` | Clears all output in the current Web REPL log
|
||
`clearall` | Clears the command history and all output in the current Web REPL log
|
||
`fullscreen` | Toggles the Web REPL terminal into, and out of, fullscreen view in the browser window
|
||
`help` | Prints the list of all available REPL commands with short descriptions
|
||
`refresh` | Refresh data on the current Vault GUI page to see the affects of a recent command
|