zerotier-idtool
Manage ZeroTier cryptographic identities
TLDR
Generate new identity
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 filegetpublic secretfile_
Output public identity from secretsign secretfile filetosign_
Sign file with identityverify publicfile file signature_
Verify signature against public identityinfo identityfile_
Display identity information (address, type)initmoon identityfile_
Initialize moon (custom root) definitiongenmoon 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
zerotier-cli(1), zerotier-one(8)
