Put a Secret

Add a secret into a vault

General Usage:

slv vault --vault <PATH_TO_VAULT> put [flags]

Flags:

Flag	Arguments	Required	Default	Description
--name	String	False	None	Name of the item (key)
--value	String	False	None	Value of the item
--plaintext	None	NA	NA	Add the value as plain text
--force	None	NA	NA	Overwrite the item if it already exists
--value	String	False	None	Value of the item
--file	String	False	None	Import items from a YAML/JSON file. The file needs to be flat
--vault	String	True	NA	Path to the SLV Vault file
--help	None	NA	NA	Help text for slv vault put

---

Adding a secret directly

Usage:

slv vault --vault <PATH_TO_VAULT> put --name <ITEM_KEY> --value <ITEM_VALUE>

Example:

$ slv vault --vault test.slv.yaml put --name my_secret --value this_is_super_sensitive
Updated secret:  my_secret  to vault:  test.slv.yaml

$ cat test.slv.yaml 
# This file is managed by SLV. DO NOT EDIT THIS FILE MANUALLY.
# Use the pattern {{SLV_VID_Q6EZYDJFO3LPK6XPBJ6L7FQOK4QFBMMKHRDSJI5D6PNBK4MP.YOUR_SECRET_NAME}} as placeholder to reference data from this vault into files
apiVersion: slv.sh/v1
kind: SLV
metadata:
    annotations:
        slv.sh/version: v0.16.3
    creationTimestamp: "2025-04-25T07:54:38Z"
    name: test
spec:
    slvConfig:
        id: SLV_VID_Q6EZYDJFO3LPK6XPBJ6L7FQOK4QFBMMKHRDSJI5D6PNBK4MP
        publicKey: SLV_VPK_AEAVMAAAACYH33FBSJWDB7R4QUGQMPBX2F4DZLWC5LLZIAWSA7EQPDEYEP7A6
        wrappedKeys:
            - SLV_EWK_AFCWQCZ7XYACMAIBIUAAAAFCQPSQVXJZ4OVL66YX7KRRYTO5ULQ3G2FKU23VXJUW3HSFRGTANQAABR2XFCCCLCW3CPQEXQ7T3NBLE7EL3IMI3D27DDRALFTYHJ4V6MK253HXHI2ZPNWV7HFI7LAPOWJI6Q6I2Q6BLI76UWYB5GDQBDE32FII4HFSUDNL6ZEJ5E75CUCXJYMOTWUTDJ4UGOTLREHVTTHMQZ3OIECEWN6Q6YQMVOPJS4DLHOAEUG4C2VVLCIMEI2Q44ALURPV7OFVTE4VI2CGSLEEWYR6SOAGKJTJM7SXTG324JYST4BPPWQSA2EET5M
            - SLV_EWK_AFCWQCZ7XYACMAIBIUAAAADAOZIIZ5QCJ4H5WLQA7Q3TOSHWXFITDK6YN7E4MBRHJBZOAKT4JAAAAG37T6TGUHZVVMV2YW6TJW3JVWATNS4JKWNUIAZHRR4VYJ2UUD2MKN4YSSRV5KG4PXQPOENULVHIGHQB7UPABKLPMOABEKSPUFXAY2WHGJW7Q5V34656FIWTSTGK3GN7SRPDVIZ3MVZ5FESSAROJIT6IN3A2QV5G4MD6YR57LTAGQINUENOJNCEZY36WBJKDKHIAWU7LCS3JGRHYBCRAP4W2AYPB46OWLKQY4ZGAMDGQHAJDOKFARI6PCNBMGI
    slvData:
        my_secret: SLV_VSS_AFLGQC2UMIACMAIBKYAAAAFQPXWKDETMGD7DZBINAY6DPULYHSXMF2WXSQBNEB6JA6GJQI76B4AABLTNSXCAHOYE3V2QAVW5IMTWYD4Z5WSHPYDV3RGWPKFV7AIWUFLCXPBE55T7I4ILMTPLRDTKYDRH7RPPLH3WAKHHFRABZU7X6RB6D4UYJRLR2E2ECTOJPKZ42T3FZB3DWFLUAEUOS3CWTHFHTNRE4D6HTNHBYDUENWP3EMKFC5P3NQ

Notice the secret being added into the vault file.

---

Importing secrets from a file

Usage:

slv vault --vault <PATH_TO_VAULT> put --file <PATH_TO_FILE>

Example:

$ cat secrets.yaml 
username: johndoe
password: super_secret_password

$ slv vault --vault test.slv.yaml put --file secrets.yaml 
Successfully imported secrets from secrets.yaml into the vault test.slv.yaml

$ cat test.slv.yaml 
# This file is managed by SLV. DO NOT EDIT THIS FILE MANUALLY.
# Use the pattern {{SLV_VID_Q6EZYDJFO3LPK6XPBJ6L7FQOK4QFBMMKHRDSJI5D6PNBK4MP.YOUR_SECRET_NAME}} as placeholder to reference data from this vault into files
apiVersion: slv.sh/v1
kind: SLV
metadata:
    annotations:
        slv.sh/version: v0.16.3
    creationTimestamp: "2025-04-25T07:54:38Z"
    name: test
spec:
    slvConfig:
        id: SLV_VID_Q6EZYDJFO3LPK6XPBJ6L7FQOK4QFBMMKHRDSJI5D6PNBK4MP
        publicKey: SLV_VPK_AEAVMAAAACYH33FBSJWDB7R4QUGQMPBX2F4DZLWC5LLZIAWSA7EQPDEYEP7A6
        wrappedKeys:
            - SLV_EWK_AFCWQCZ7XYACMAIBIUAAAAFCQPSQVXJZ4OVL66YX7KRRYTO5ULQ3G2FKU23VXJUW3HSFRGTANQAABR2XFCCCLCW3CPQEXQ7T3NBLE7EL3IMI3D27DDRALFTYHJ4V6MK253HXHI2ZPNWV7HFI7LAPOWJI6Q6I2Q6BLI76UWYB5GDQBDE32FII4HFSUDNL6ZEJ5E75CUCXJYMOTWUTDJ4UGOTLREHVTTHMQZ3OIECEWN6Q6YQMVOPJS4DLHOAEUG4C2VVLCIMEI2Q44ALURPV7OFVTE4VI2CGSLEEWYR6SOAGKJTJM7SXTG324JYST4BPPWQSA2EET5M
            - SLV_EWK_AFCWQCZ7XYACMAIBIUAAAADAOZIIZ5QCJ4H5WLQA7Q3TOSHWXFITDK6YN7E4MBRHJBZOAKT4JAAAAG37T6TGUHZVVMV2YW6TJW3JVWATNS4JKWNUIAZHRR4VYJ2UUD2MKN4YSSRV5KG4PXQPOENULVHIGHQB7UPABKLPMOABEKSPUFXAY2WHGJW7Q5V34656FIWTSTGK3GN7SRPDVIZ3MVZ5FESSAROJIT6IN3A2QV5G4MD6YR57LTAGQINUENOJNCEZY36WBJKDKHIAWU7LCS3JGRHYBCRAP4W2AYPB46OWLKQY4ZGAMDGQHAJDOKFARI6PCNBMGI
    slvData:
        my_secret: SLV_VSS_AFLGQC2UMIACMAIBKYAAAAFQPXWKDETMGD7DZBINAY6DPULYHSXMF2WXSQBNEB6JA6GJQI76B4AABLTNSXCAHOYE3V2QAVW5IMTWYD4Z5WSHPYDV3RGWPKFV7AIWUFLCXPBE55T7I4ILMTPLRDTKYDRH7RPPLH3WAKHHFRABZU7X6RB6D4UYJRLR2E2ECTOJPKZ42T3FZB3DWFLUAEUOS3CWTHFHTNRE4D6HTNHBYDUENWP3EMKFC5P3NQ
        password: SLV_VSS_AFLGQC2VDEACMAIBKYAAAAFQPXWKDETMGD7DZBINAY6DPULYHSXMF2WXSQBNEB6JA6GJQI76B4AABSJBUHNYKE7ZVGJNO7RYOU5QWZSDL6HHI5FRDLL7X4NNCXNXXGAY6DPZQXAI22MEHKVETI52QMGSXR7H4LPUVDLIAOIBJMCVLTUSJLIHUFUWYM74YGX74M5XY2RZZO4YJPC2WMKTAG5NVPLCJO3T6OISM66UGWCJNJVPKUCDR5Q
        username: SLV_VSS_AFLGQC2VDEACMAIBKYAAAAFQPXWKDETMGD7DZBINAY6DPULYHSXMF2WXSQBNEB6JA6GJQI76B4AABSJBUHNYKE7ZVGJNO7RYOU5QWZSDL6HHI5FRDLL7X4NNCXNXXGAYGG5V7TC5BALTGYZAKVZDDHDMPKIL2QLOTPSNGJABTB64AP33Z6ZX5VIND67BFLP2WZKIENPAC5FB6LIRSIGGJZJLFJ2L47IP