emcomm-tools-os-community/overlay/etc/skel/Desktop/offline/crypto/gpg-cheatsheet.md

title, date, updated, author, categories, tags, copyright

title	date	updated	author	categories	tags	copyright
GNU Privacy Guard: Crypto Cheetsheet	2026-03-19	2026-03-19	The Tech Prepper	cryptography	gpg pgp	(C) 2026 The Tech Prepper, LLC

This is an in-progress cheatsheet for performing basic cryptographic functions using GNU Privacy Guard (gpg), including encrypting, decrypting, and verifying files in an offline environment.

Add Key

Import a public key into your keyring.

1. Download the public key from the trusted individual. It can be saved anywhere. For ease of backup, save them under ~/keys/. Create this directory if it does not exist in your home directory.

2. Import the key file.

   gpg --import KEYFILE

3. Verify the key fingerprint. Your trusted source should provide you with the fingerprint. From the example above, the fingerprint is the value starting with 77F8.

   gpg --fingerprint

4. Optionally, edit the key and set the trust level. See the "Set Trust Level" section.

5. For an off-grid use case, where you trust the key, you can sign it youself to mark the key valid on your machine.

   gpg --lsign-key FINGERPRINT

Here's an example from EmComm Tools Community R6 that imports the AmRRON public key.

$ gpg --import ~/Desktop/offline/nets/amrron/AmRRON_Actual_ECC_PUBLIC.asc

List Public Keys

List the current public keys on your system.

gpg --list-keys

Use the following to interpret the keys listed:

• pub - Primary key
  • Your identity
  • Used for signing and certifying other keys
• sub - Subkey
  • Used for specific operations (usually encryption)
  • Can be replaced or rotated without changing identity
  • Can be revoked or rotated if compromised
• [SC] - Sign + Certify
• [E] - Encrypt
• unknown|full|ultimate - See "Set Trust Levels"

Here's an example showing the AmRRON public key.

$ gpg --list-keys
/home/ham/.gnupg/pubring.kbx
-------------------------------
pub   ed25519 2023-05-25 [SC]
      77F888F3524F00C75FF9F91A8D518D7A50612239
uid           [ unknown] AmRRON Actual (ECC) <amrron@actual.net>
sub   cv25519 2023-05-25 [E]

Verify Signature

There are two common types of signed files:

1. Inline (clearsigned) message

A single file that contains both the message and the signature. For example, the AmRRON Intelligence Brief (AIB) uses an inline message.

gpg --verify COMBINEDFILE

2. Detached signature

A file and a separate signature file.

gpg --verify SIGNATUREFILE FILE

Here's an example from EmComm Tools Community R6 that verifies that the AIB distributed by AmRRON on the nationwide net on March, 16, 2026 was created by AmRRON.

$ gpg --verify ~/Desktop/offline/nets/amrron/NATL-RR-260316-1330Z-AIB-sig.k2s 
gpg: Signature made Mon 16 Mar 2026 06:22:46 AM MST
gpg:                using EDDSA key 77F888F3524F00C75FF9F91A8D518D7A50612239
gpg: checking the trustdb
gpg: marginals needed: 3  completes needed: 1  trust model: pgp
gpg: depth: 0  valid:   1  signed:   1  trust: 0-, 0q, 0n, 0m, 0f, 1u
gpg: depth: 1  valid:   1  signed:   0  trust: 0-, 0q, 0n, 0m, 1f, 0u
gpg: Good signature from "AmRRON Actual (ECC) <amrron@actual.net>" [full]

Create Key

Generate a new private/public key pair using ECC. It is a modern standard that provides strong security and works well for radio use due to smaller key sizes.

1. Create a primary key for signing using ECC. Replace FIRSTNAME, LASTNAME, and EMAIL (keep the < and > characters).

   gpg --quick-generate-key "FIRSTNAME LASTNAME " ed25519 sign 0

2. List your keys and identify the fingerprint of your new key.

   gpg --list-keys

3. Generate an encryption subkey. Replace FINGERPRINT.

   gpg --quick-add-key FINGERPRINT cv25519 encrypt 0

4. List your keys again. You should now see a subkey that is suitable for encryption ([E]).

   gpg --list-keys

List Private Keys

List the current private keys on your system.

gpg --list-secret-keys

Sign File

TODO

Encrypt File

gpg -e -r RECIPIENT file.txt

Decrypt File

gpg -d file.txt.gpg

Set Trust Levels

Here are common trust levels for basic use:

• unknown - No trust assigned (default)
• full - You trust this person to sign other keys
• ultimate - Your own key

Perform the following steps to change the trust level for a key.

1. List the keys and identify the key ID (KEYID).

   gpg --list-keys

2. Replace KEYID with the key ID to edit.

   gpg --edit-key KEYID

3. Type trust and press [ENTER].

4. Type the number for the desired trust level and press [ENTER].

5. Type quit to exit.