Search…
Installation
The CLI is only available for private cloud customers
For general users it is recommended to download the binary for your platform. Latest release can be found here: https://github.com/magneticio/forklift/releases/latest

Linux and MacOS Users

If you have curl installed, you can install the tool using these commands:
1
version=$(curl -s https://api.github.com/repos/magneticio/forklift/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/') &&
2
base=https://github.com/magneticio/forklift/releases/download/$version &&
3
curl -sL $base/forklift-$(uname -s)-$(uname -m) >/usr/local/bin/forklift &&
4
chmod +x /usr/local/bin/forklift
Copied!

Verify the Installation

Run the following command to verify that the tool is installed correctly:
1
forklift version
Copied!

Configuration

File

To configure the tool, you need to create a configuration file that contains the URL of Hashicorp Vault and a Vault token with CRUDL permissions for the intended base path.
The default project and default cluster are optional.
1
key-value-store-url: http://vault.my-domain:8200
2
key-value-store-token: s.NotARealToken
3
key-value-store-base-path: /secret/vamp/
4
project: 1
5
cluster: 1
Copied!
The config file can be passed as part of each command using --config <file> .

Linux and MacOS Users

Alternatively, you can place the configuration in ~/.forklift/config.yaml.

Environment Variables

Environment variables can be used as an alternative to using a config file.
They can also be used in combination with a config file.
When environment variables and a config file are used together, the environment variables override the values in the config file.
1
VAMP_FORKLIFT_PROJECT
2
# Vamp Project ID
3
VAMP_FORKLIFT_CLUSTER
4
# Vamp Cluster ID
5
VAMP_FORKLIFT_VAULT_ADDR
6
# Vault address. Example: http://vault.my-domain:8200
7
VAMP_FORKLIFT_VAULT_TOKEN
8
# Vault token
9
VAMP_FORKLIFT_VAULT_BASE_PATH
10
# Vault base path. Example: /secret/vamp/
11
VAMP_FORKLIFT_VAULT_CACERT
12
# Path of the CA Certificate.
13
VAMP_FORKLIFT_VAULT_CLIENT_CERT
14
# Path of the Client Certificate for TLS
15
VAMP_FORKLIFT_VAULT_CLIENT_KEY
16
# Path of the Client Certificate Key for TLS
Copied!
Last modified 7mo ago