Skip to content

Saving Your Configuration Files

jj edited this page Sep 20, 2026 · 5 revisions

Backing Up Your zBitx Configuration Files

Backing up your configuration files helps prevent headaches and saves time when changing, reloading, or upgrading your zBitx operating system.

Important Files, Their Purpose, and Locations

Essential Configuration Files (Highly Recommended for Backup)

These files store critical settings and logs unique to your setup:

  • hw_settings.ini

    • Contains power output calibration data unique to each sBitx mainboard.
    • Location: /home/pi/sbitx/data
  • user_settings.ini

    • Stores callsign information, band-stacking frequency data, and other custom settings in the GUI.
    • Location: /home/pi/sbitx/data
  • sbitx.db

    • Stores QSO logs.
    • Location: /home/pi/sbitx/data
  • "filename".mc

    • Contains macros used in FT8 and CW modes.
    • Location: /home/pi/sbitx/web

Backup Requirements


Backup Procedures

1. Using EZData (Recommended)

The zBitx-Toolbox application, EZ Data, provides an easy way to back up essential files. Get it from https://github.com/drexjj/zbitx-toolbox

Steps:

  1. Power on the zBitx.
  2. Insert the USB storage drive into the micro-USB adapter and then insert it into the port labelled USB
  3. Open the VNC Window in a web browser from https://zbitx.local:8443
  4. Open zBitx-Toolbox, then launch EZ Data.
  5. Click Refresh and select your USB drive.
  6. Press "Backup Files To The Selected USB Drive" and wait for a completion message.

2. Manual Backup (Alternative Method)

For manual backups, you can use the file manager to copy files to your USB storage drive.

Steps:

  1. Power on the zBitx.
  2. Insert the USB storage drive into the micro-USB adapter and then insert it into the port labelled USB
  3. Open File Manager and navigate to the directories listed above.
  4. Open another File Manager window and go to /media/pi/"USB drive name".
  5. Right-click the necessary files in the zBitx directories, select Copy, then Paste them into the USB drive folder.

Important Note

When changing operating systems or reflashing the SD card, you must restore at least the hw_settings.ini file to retain calibration data.

Clone this wiki locally