Install BerryCore

From zero to a working QNX extended userland on your BlackBerry 10 device. Use BerryBridge for the easiest path, or follow the manual steps below.

01

Download

Get berrycore.zip and install.sh from the GitHub Releases page (v0.83.0+).

02

Transfer

Copy to the device via BerryBridge WiFi Storage, USB, or SFTP. Target: documents/ or downloads/.

03

Install

Extract and run sh install.sh in Term48 or SSH. Default: /accounts/1000/shared/misc/berrycore.

04

Activate

Source env.sh, run qpkg update, then berrymsg register for fleet access.

Before you start

  • BlackBerry 10 device with Development Mode enabled (for SSH and sideloading)
  • Device and computer on the same WiFi network (for BerryBridge scan and WiFi Storage)
  • Enough free storage for the BerryCore archive (check release notes for size)

Option A — BerryBridge (recommended)

  1. Install BerryBridge on your desktop
  2. Download the latest BerryCore release inside the app or from GitHub
  3. Scan for your device, or add it manually with its IP address
  4. Upload berrycore.zip to Documents via WiFi Storage
  5. SSH in (port 2022) and run: cd ~/documents && unzip berrycore.zip && sh install.sh
  6. Let BerryBridge provision your SSH key for future sessions

Option B — Manual install

  1. Download from GitHub Releases
  2. Transfer the zip to your device by any method you prefer
  3. Open Term48 on the device or SSH from your computer
  4. Extract: unzip berrycore.zip
  5. Run: sh install.sh
  6. Activate: source /accounts/1000/shared/misc/berrycore/env.sh
  7. Update packages: qpkg update

After install

Add to your shell profile so BerryCore loads automatically:

source /accounts/1000/shared/misc/berrycore/env.sh

Register with the fleet gateway: berrymsg register (saves a device token). See the gateway page for details.

Video walkthroughs

Prefer video? See our step-by-step YouTube guides for transfer, install, and SSH setup.

Troubleshooting

  • SSH connection refused — enable Development Mode, confirm port 2022, check device IP
  • Install path errors — ensure enough storage; try shared/misc/ path from install.sh prompts
  • qpkg errors — re-source env.sh and run qpkg update again
  • Need help?open a GitHub issue