📖

SECURITY GUIDE

Everything you need to know about protecting your firearms data.
User flows, best practices, warnings, and tips.

QUICK REFERENCE

🔑

PIN Only

App Lock

  • Locks app UI only
  • Data NOT encrypted
  • Forgot PIN? Reinstall app
  • Free for all users
🔐

PIN + Encryption

Data Protection

  • Locks app + encrypts data
  • Forgot PIN? Data LOST
  • Generate backup QR!
  • Pro feature
🔒

Biometric + PIN + Encryption

Maximum Security

  • Two-factor auth
  • Full encryption
  • Forgot PIN? Data LOST
  • Pro feature

USER FLOWS

🎯

First Time Setup (Recommended for Most Users)

1

Install ArmoryHub

Download from App Store, complete welcome flow

2

Add a few test firearms

Get familiar with the app before setting up security

3

Go to Settings → Security

Review all security options available

4

Enable Face ID / Touch ID

Quick biometric unlock for convenience

5

Enable 6-Digit PIN

Follow setup flow, choose strong PIN (avoid 123456, 111111)

6

Test PIN unlock

Background app, reopen, verify PIN works

7

Decide: Encryption or not?

PIN-only = convenience, Encryption = maximum security

🔐

Enabling Encryption (Pro Users)

⚠️ Read carefully—mistakes here cause permanent data loss

1

Ensure PIN is enabled

Encryption requires PIN first (to protect the master key)

2

Toggle 'Data Encryption' ON

Comprehensive warning sheet appears

3

READ THE WARNING CAREFULLY

Understand: If you forget PIN, data is PERMANENTLY LOST

4

Enter your PIN to confirm

This generates a new 256-bit encryption key

5

Wait for encryption to complete

May take 30-60 seconds for large inventories

6

IMMEDIATELY generate backup QR

Go to 'Disaster Recovery' → Generate Backup Recovery Key

7

Store backup QR securely

Save to 1Password, print to paper, store in safe

8

Test: Background and reopen app

Verify data encrypts/decrypts properly

📱

Multi-Device Setup (iCloud Sync + Encryption)

1

Device A: Enable PIN + Encryption

Follow encryption setup flow above

2

Device A: Generate temporary QR code

Security → Multi-Device Setup → Export Key

3

Device B: Install ArmoryHub

Do NOT set up PIN on Device B yet

4

Device B: Import QR code

Security → Multi-Device Setup → Import Key (scan Device A's QR)

5

Device B: Enter SAME PIN

Must match Device A exactly

6

Device B: Wait for encryption

Existing data encrypts automatically

7

Test iCloud sync

Add item on Device A, verify it syncs to Device B (encrypted)

BEST PRACTICES

DO: Generate Backup Recovery QR Immediately

After enabling encryption, IMMEDIATELY create a backup recovery QR code. This is your ONLY way to recover data if you lose all devices.

DO: Store Backup QR Securely

Save your backup QR to a password manager (1Password, Bitwarden), print it and store in a safe, or take a screenshot and save to encrypted cloud storage. Treat it like a password—anyone with this QR + your PIN can decrypt your data.

DO: Use a Strong 6-Digit PIN

Avoid: 123456, 111111, 123123, 000000, birth dates. Recommended: Random 6 digits, or a meaningful-to-you number that's not obvious (last 6 digits of old phone number, etc.)

DO: Test Your Backup QR Code

After generating a backup QR, test it on a second device or by removing/reinstalling the app. Verify you can actually recover with it BEFORE you need it in an emergency.

DO: Understand PIN vs Encryption

PIN alone = app lock only (data in plaintext). PIN + Encryption = app lock + data protection. Choose based on your threat model.

DON'T: Forget to Generate Backup QR

This is the #1 user mistake. 'I enabled encryption but didn't make a backup QR, then my phone died' = permanent data loss. We cannot recover your data—the encryption key only exists on your devices.

DON'T: Share Your Backup QR Publicly

Your backup QR code contains your encrypted master key. Anyone with this QR + your PIN can decrypt ALL your data. Don't post it on social media, send via email, or store in unsecured locations.

DON'T: Use Encryption if You Frequently Forget PINs

If you often forget passwords/PINs, stick with PIN-only mode (no encryption). You can always reinstall the app if you forget your PIN. With encryption enabled, forgotten PIN = permanent data loss.

⚠️

CAUTION: Changing PIN Invalidates Old QR Codes

When you change your PIN, all previously generated QR codes stop working (they contain the master key encrypted with your OLD PIN). After changing PIN, generate new backup QR codes.

⚠️

CAUTION: iCloud Sync + Encryption Complexity

With encryption enabled and iCloud sync on, data syncs as encrypted blobs. Other devices must import your encryption key via QR code. If you lose all devices, iCloud backup is useless without the key.

⚠️

CAUTION: ZIP Backups Are UNENCRYPTED

ArmoryHub offers ZIP export backups of your entire inventory. These ZIP files contain your data in PLAINTEXT (CSV format)—even if encryption is enabled in the app. NEVER store unprotected ZIP backups in unsecured locations. ALWAYS add a password to the ZIP file before storing or sharing. Recommended: Use 7-Zip or WinRAR to add AES-256 password protection to your backup ZIPs.

BACKUP EXPORT SECURITY

📦

IMPORTANT: ZIP Backups Are NOT Encrypted

When you export your inventory as a ZIP backup, the data is exported in plaintext CSV format—even if you have encryption enabled in the app. This is intentional to ensure compatibility and recoverability, but it requires careful handling.

⚠️ Security Risks:

  • ZIP backup contains ALL your data in readable format (serial numbers, locations, tax stamps, etc.)
  • Anyone who finds the ZIP can open it and read your entire inventory
  • Email attachments and cloud storage (Dropbox, Google Drive) may be accessed by providers or breached
  • Unencrypted backups defeat the purpose of in-app encryption

✅ Recommended Security Practices:

  • 1.Add a password to the ZIP file: Use 7-Zip, WinRAR, or macOS Archive Utility to add AES-256 encryption to the ZIP. Choose a strong password (12+ characters, mix of letters/numbers/symbols).
  • 2.Store in secure locations only: Password manager (1Password, Bitwarden), encrypted external drive, physical safe. NOT in email, Dropbox, or unencrypted cloud storage.
  • 3.Delete after restoring: Once you've verified the backup can be restored, delete the unencrypted ZIP from your computer. Keep only the password-protected version.
  • 4.Use unique password: Don't reuse your ArmoryHub PIN or other passwords. This ensures if one is compromised, the backup stays protected.
  • 5.Test restoration: Before you need it in an emergency, test that you can import the ZIP backup and all data appears correctly.

🔐 BEST PRACTICE: Export Backup → Add Password to ZIP → Store in Password Manager → Delete Unprotected Original

💡How to Password-Protect ZIP (macOS)

  1. 1. Right-click the ZIP file
  2. 2. Select "Encrypt [filename]"
  3. 3. Enter a strong password (12+ characters)
  4. 4. Verify password
  5. 5. Original ZIP is replaced with encrypted version

macOS uses AES-128 by default. For AES-256, use terminal: zip -e -r backup.zip folder/

💡How to Password-Protect ZIP (Windows)

  1. 1. Download 7-Zip (free, open-source)
  2. 2. Right-click ZIP → 7-Zip → Add to archive
  3. 3. Encryption method: AES-256
  4. 4. Enter password (12+ characters)
  5. 5. Click OK to create encrypted ZIP

7-Zip is recommended for Windows. Built-in Windows ZIP encryption uses older ZipCrypto (less secure than AES-256).

COMMON SCENARIOS

🔴

I forgot my PIN and encryption is enabled. Can you help me recover my data?

Unfortunately, no. This is a fundamental security feature, not a bug. Your data is encrypted with a key derived from your PIN. Without the PIN, the key cannot be derived, and the data cannot be decrypted. This is the same security that protects banking apps and military communications. If you have a backup recovery QR code stored somewhere safe, you can use that to recover on a new device.

I forgot my PIN but encryption is NOT enabled. What do I do?

Good news! Since encryption is disabled, your data is stored in plaintext and is NOT encrypted. Simply delete the app and reinstall it. Your data will sync back from iCloud (if enabled) in plaintext, and you can set up a new PIN. This is why we separate PIN (authentication) from encryption (data protection).

⚠️

My phone died and I need to restore from iCloud backup. Will my encrypted data survive?

Yes, BUT you need your PIN. When you restore your iPhone and install ArmoryHub, your encrypted data will sync down from iCloud. You'll need to either: (1) Import your encryption key from another device via QR code, or (2) Use your backup recovery QR code. Without one of these, your synced data will remain encrypted and unreadable.

Can I use encryption with only one device (no iCloud sync)?

Absolutely! This is the MOST secure configuration. Enable PIN + Encryption, then disable iCloud sync in Settings. Your data never leaves your device. Perfect for maximum security. Just make sure to generate and safely store a backup recovery QR in case your device is lost/damaged.

ℹ️

I enabled encryption and now the app is slower. Is this normal?

You may notice a 1-2 second delay when unlocking the app (while data decrypts) and when backgrounding (while data encrypts). This is normal. We're encrypting/decrypting thousands of text fields. For most users, this delay is imperceptible on modern iPhones.

ℹ️

What happens if I enable encryption, then change my mind?

You can toggle encryption off anytime. Your data will be decrypted back to plaintext, but your encryption key stays in the Keychain (in case you want to re-enable later). To completely remove encryption, you must disable PIN (which deletes the key). Just remember: disabling encryption means your data is no longer protected at rest.

🔴

Are ZIP backup exports encrypted?

No. ZIP backups are exported in PLAINTEXT CSV format—even if encryption is enabled in the app. This ensures compatibility and allows you to recover data outside the app. CRITICAL: Always add a password to ZIP backups before storing them. Use 7-Zip (Windows) or macOS Terminal to add AES-256 encryption. Store password-protected ZIPs in secure locations only (password managers, encrypted drives, safes). Never email or upload unprotected backups to cloud storage.

Can I import password-protected ZIP backups?

Yes. When importing a backup, ArmoryHub will prompt for the ZIP password if it's protected. The app extracts the CSV files, imports the data, then discards the temporary files. Your password is never stored. Recommendation: Use password-protected ZIPs for all backups as a second layer of security.

CRITICAL WARNINGS

⚠️

Forgotten PIN + Encryption = Permanent Data Loss

  • If encryption is enabled and you forget your PIN, your data CANNOT be recovered
  • We don't have a master password or backdoor—this is a security feature
  • Even Apple support cannot help you—the encryption key is on your device only
  • Your only recovery option is a backup recovery QR code (if you generated one)
🔥

Lost All Devices + Encryption = iCloud Data is Useless

  • Your encryption keys are stored in device Keychain—NOT in iCloud
  • If you lose all devices and don't have a backup QR, your iCloud data is encrypted garbage
  • iCloud only stores encrypted blobs—it doesn't store the keys to decrypt them
  • Solution: Always keep at least one device active OR save a backup QR code
📸

Backup QR Codes Are Like Passwords

  • Anyone with your backup QR code + your PIN can decrypt ALL your data
  • Don't post QR codes on social media or send via unencrypted email
  • If a QR is compromised, change your PIN immediately (this regenerates encryption)
  • Store QR codes in password managers or physical safes—not in unsecured cloud storage

TIPS & TRICKS

💡

Start with PIN-Only, Add Encryption Later

New to the app? Enable PIN first to protect against casual access. Once you're comfortable and have backed up your data, enable encryption for maximum security. You can always add encryption later.

💡

Use Auto-Lock 'Immediately' for Encryption

When encryption is enabled, the app automatically hides the 'Never' timeout option. We recommend 'Immediately' for encrypted data—this ensures data is locked as soon as you leave the app.

💡

Test Backup QR on a Secondary Device

After generating a backup QR, test it! Install ArmoryHub on an iPad or old iPhone, import the QR, verify it works. Better to discover issues now than during an emergency.

💡

Multiple Backup QRs in Different Locations

Generate one backup QR and save it in: (1) Password manager, (2) Printed in safe, (3) Encrypted USB drive. Redundancy prevents total loss if one location fails.

💡

Temporary QR for New Devices (5 min expiry)

When setting up a new device, use the temporary QR code (expires in 5 minutes). These are one-time use for security. For recovery, use the non-expiring backup QR.

💡

Offline Mode for Maximum Security

Ultimate security: Enable PIN + Encryption, then disable iCloud sync. Your data never leaves your device. Perfect if you never want your firearms data in any cloud, even encrypted.

💡

Wife Mode Works Regardless of Security

The legendary Wife Mode (shows all values at 50% of actual price) works with or without encryption. Mission-critical feature operates independently of security settings.

💡

Lock Button for Instant Security

Tap the 'LOCK' button in the top-right of the app to immediately encrypt data and lock the app. Useful before handing device to someone or entering a public space.

WHICH SECURITY LEVEL IS RIGHT FOR ME?

Scenario:

I share my device with family members

Recommendation:

BIOMETRIC ONLY or PIN ONLY

Reasoning:

Prevents family from accidentally deleting firearms or seeing purchase prices. No encryption needed unless data is highly sensitive.

Scenario:

I have NFA items with tax stamps and trust names

Recommendation:

PIN + ENCRYPTION

Reasoning:

NFA data is legally sensitive. Encryption protects serial numbers, tax stamp numbers, and trust information from unauthorized access.

Scenario:

I'm worried about device theft

Recommendation:

BIOMETRIC + PIN + ENCRYPTION

Reasoning:

Two-factor auth prevents casual access. Encryption prevents forensic data extraction. Thief cannot access data even with professional tools.

Scenario:

I use iCloud sync across multiple devices

Recommendation:

PIN + ENCRYPTION + QR Code Transfer

Reasoning:

Encryption ensures data syncs as encrypted blobs. QR codes transfer keys securely between your devices offline. iCloud never sees your keys.

Scenario:

I'm a competitive shooter tracking DOPE data

Recommendation:

BIOMETRIC ONLY or PIN ONLY

Reasoning:

DOPE data isn't legally sensitive. PIN-only gives quick access while preventing others from modifying your data. Encryption is overkill for this use case.

Scenario:

I'm in a jurisdiction with strict firearms laws

Recommendation:

OFFLINE + PIN + ENCRYPTION

Reasoning:

Maximum privacy: Disable iCloud sync entirely. Enable PIN + Encryption. Data never leaves your device, even encrypted. Generate backup QR and store physically (not digitally).

EMERGENCY RECOVERY PROCEDURES

Forgot PIN + iCloud Sync Enabled (Encryption NOT Enabled)

  1. 1.Delete ArmoryHub from device
  2. 2.Reinstall from App Store
  3. 3.Sign in with same Apple ID
  4. 4.Enable iCloud sync (Settings → iCloud Sync)
  5. 5.Wait for data to sync down (appears in plaintext)
  6. 6.Set up new PIN
  7. 7.You're recovered! ✅
⚠️

Forgot PIN (Encryption Enabled, Have Backup QR)

  1. 1.Install ArmoryHub on a new device (or reinstall on same device)
  2. 2.Do NOT set up a new PIN yet
  3. 3.Go to Security → Multi-Device Setup → Import Key
  4. 4.Scan your backup recovery QR code
  5. 5.Enter your PIN (the one you forgot... wait, you need to remember it!)
  6. 6.If you truly forgot: Try common PINs you use, birth dates, etc.
  7. 7.After 5 failed attempts, QR locks (generate new QR from another device if available)
🔴

Forgot PIN (Encryption Enabled, NO Backup QR, NO Other Devices)

  1. 1.Your data is permanently lost. There is no recovery.
  2. 2.Delete app and start fresh with new inventory
  3. 3.This time, IMMEDIATELY generate a backup QR after enabling encryption
  4. 4.Consider using PIN-only mode if you frequently forget PINs

Lost Device (Have Another Device with Encryption Key)

  1. 1.On surviving device: Generate new backup QR code
  2. 2.Store it securely
  3. 3.On new device: Install app, import QR code with your PIN
  4. 4.Data syncs from iCloud (encrypted) and decrypts automatically
  5. 5.You're recovered! ✅

FREQUENTLY ASKED QUESTIONS

Can you reset my PIN if I forget it?

No. We cannot reset your PIN because we don't have access to it. Your PIN is hashed locally on your device and never transmitted to us. This is a security feature, not a limitation. If encryption is disabled, you can delete/reinstall the app. If encryption is enabled and you don't have a backup QR, your data is unrecoverable.

Why can't I use 'Never' auto-lock when encryption is enabled?

For security. With encryption enabled, the master key must be periodically cleared from memory. The 'Never' option would keep the key in memory indefinitely, increasing risk from memory dump attacks. We automatically hide this option when encryption is on.

What happens to my data when the app is backgrounded?

With encryption enabled: Data is re-encrypted when you background the app, then the master key is cleared from memory. When you return, you authenticate with PIN, data is decrypted back to plaintext for app use. With PIN-only: Nothing happens—data stays in plaintext.

How long does encryption/decryption take?

Depends on inventory size. Small inventory (10-50 items): ~1 second. Medium (100-500 items): 2-5 seconds. Large (1000+ items): 10-30 seconds. This happens in the background with a progress indicator.

Can I export my data if encryption is enabled?

Yes. Export happens while the app is unlocked (data is decrypted in memory). Exported files are NOT encrypted—they're plain CSV/PDF files. If you want to share encrypted exports, manually encrypt the export files before sharing.

Is biometric data stored in ArmoryHub?

No. Face ID / Touch ID data never leaves Apple's Secure Enclave and is never accessible to apps. We simply ask iOS 'is this the device owner?' and iOS responds yes/no. Your biometric templates stay with Apple, not us.

👨‍💻

About This Project

ArmoryHub is built by a single independent developer who is passionate about firearms, security, and creating tools that solve real problems. This isn't a big corporation—it's one person who cares about getting it right.

Questions? Feedback? Security concerns? Email: support@armoryhub.app

READY TO SECURE YOUR COLLECTION?

Download ArmoryHub and choose the security level that's right for you.

Download on theApp Store