LinuxCommandLibrary

zerotier-idtool

Manage ZeroTier cryptographic identities

TLDR

Generate new identity

$ zerotier-idtool generate [identity.secret]
copy
Get public identity from secret
$ zerotier-idtool getpublic [identity.secret]
copy
Sign a file
$ zerotier-idtool sign [identity.secret] [file]
copy
Verify signature
$ zerotier-idtool verify [identity.public] [file] [signature]
copy
Show identity address
$ zerotier-idtool info [identity.secret]
copy

SYNOPSIS

zerotier-idtool command [args]

DESCRIPTION

zerotier-idtool manages ZeroTier cryptographic identities. Identities consist of a secret key (kept private) and a public key that derives the 10-digit ZeroTier address.
The tool can generate new identities, extract public keys, and perform cryptographic operations like signing and verification. This is useful for backup, migration, and creating custom network infrastructure.
Identities are automatically generated when zerotier-one first starts, stored in the ZeroTier home directory (typically /var/lib/zerotier-one/).
For advanced users, the tool supports creating "moons" - custom root servers for private ZeroTier infrastructure.

SUBCOMMANDS

generate secretfile_

Generate new identity, write to file
getpublic secretfile_
Output public identity from secret
sign secretfile filetosign_
Sign file with identity
verify publicfile file signature_
Verify signature against public identity
info identityfile_
Display identity information (address, type)
initmoon identityfile_
Initialize moon (custom root) definition
genmoon moonjson_
Generate moon.d file from JSON definition

CAVEATS

identity.secret files must be kept secure. Anyone with this file can impersonate that ZeroTier node.
Regenerating an identity creates a new address. Existing network memberships must be re-authorized.
Moon creation requires understanding ZeroTier's root server architecture.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community