---
name: "voa-import"
section: "1"
platform: "linux"
package: "voa"
version: "0.7.6-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/voa-import"
---

# voa-import(1)

Import a single verifier into a VOA hierarchy.

## NAME

voa-import - Import a single verifier into a VOA hierarchy.

## SYNOPSIS

**voa import** \[**-c**\|**--context**\] \[**-v**\|**--verbose**\]... \[**-i**\|**--input**\] \[**-q**\|**--quiet**\]... \[**-b**\|**--base-path**\] \[**-r**\|**--runtime**\] \[**-h**\|**--help**\] \<*OS*\> \<*PURPOSE*\> \<*TECHNOLOGY*\>

## DESCRIPTION

Import a single verifier into a VOA hierarchy.

By default a single verifier is expected on stdin. Using the "-i"/"--input" option a specific directory or file can be selected for import instead.

The verifier is written to the user's writable, persistent VOA load path, e.g.:

\- "~/.config/voa/": for users with uid \>= 1000.\
   Note, that "voa import" respects the XDG Base Directory Specification and the "XDG\_CONFIG\_HOME" environment variable.\
   The above serves as default example. - "/etc/voa/": for users with uid \< 1000

When using the "-r"/"--runtime" option, the verifier is written to the user's writable, ephemeral VOA load path instead, e.g.:

\- "/run/user/$(id -u)/voa/": for users with uid \>= 1000.\
   Note, that "voa import" respects the XDG Base Directory Specification and the "XDG\_RUNTIME\_DIR" environment variable.\
   The above serves as default example. - "/run/voa": for users with uid \< 1000

The verifier can be written to another, specific VOA base path using the "-b"/"--base-path" option.

## OPTIONS

- **-c**, **--context** *\<CONTEXT\>*

  The context to import for.

  If not specified, defaults to "default".

  May also be specified with the **VOA\_IMPORT\_CONTEXT** environment variable.

- **-v**, **--verbose**

  Increase logging verbosity

- **-i**, **--input** *\<INPUT\>*

  The directory or file to import from.

  If a directory is provided and the selected technology is "openpgp" it must either contain:

  \- OpenPGP packet files, - or a directory structure with OpenPGP packet files, compatible with the "archlinux-keyring" format.

  If no directory or file is provided, stdin is used instead.

  May also be specified with the **VOA\_IMPORT\_INPUT** environment variable.

- **-q**, **--quiet**

  Decrease logging verbosity

- **-b**, **--base-path** *\<BASE\_PATH\>*

  The VOA base path to write to.

  If not specified, the user's writable, persistent VOA load path is chosen, e.g.:

  \- "~/.config/voa/": for users with uid \>= 1000 - "/etc/voa/": for users with uid \< 1000

  To use the user's writable, ephemeral VOA load path if no directory is provided, pass the "-r"/"--runtime" option to the command. In this case the writable, ephemeral VOA load path is chosen, e.g.:

  \- "/run/user/$(id -u)/voa/": for users with uid \>= 1000 - "/run/voa": for users with uid \< 1000

  May also be specified with the **VOA\_IMPORT\_BASE\_PATH** environment variable.

- **-r**, **--runtime**

  Whether to import to the runtime directory.

  Instructs the import mechanism to use the user's writable, ephemeral VOA load path, e.g.:

  \- "/run/user/$(id -u)/voa/": for users with uid \>= 1000 - "/run/voa": for users with uid \< 1000

  By default, if this option and the "-b"/"--base-path" options are not provided, a verifier is imported to the writable, persistent VOA load path of the user, e.g.:

  \- "~/.config/voa/": for users with uid \>= 1000 - "/etc/voa/": for users with uid \< 1000

  Note, that this option cannot be selected together with "-b"/"--base-path".

  May also be specified with the **VOA\_IMPORT\_RUNTIME** environment variable.

- **-h**, **--help**

  Print help (see a summary with '-h')

- \<*OS*\>

  The OS to import for.

  May also be specified with the **VOA\_IMPORT\_OS** environment variable.

- \<*PURPOSE*\>

  The purpose to import for.

  May also be specified with the **VOA\_IMPORT\_PURPOSE** environment variable.

- \<*TECHNOLOGY*\>

  The technology to import for.

  Currently only "openpgp" is supported.

  May also be specified with the **VOA\_IMPORT\_TECHNOLOGY** environment variable.