How to Set Up a Raspberry Pi iBeacon?

An iBeacon is a small, low-powered Bluetooth device that broadcasts its identifier to nearby devices. They enable location-based interactions like pushing notifications, tracking analytics, and contactless check-ins.How to Set Up a Raspberry Pi iBeacon?The Raspberry Pi’s built-in Bluetooth makes it easy to set it up as an iBeacon. With just a few commands, the Pi will start broadcasting as an iBeacon that is detectable by mobile devices.


Before you set up your Raspberry Pi iBeacon, make sure you have the following:

  • A Raspberry Pi board with built-in Bluetooth or a USB Bluetooth adapter. We’ll be using Bluetooth Low Energy (BLE).
  • A mobile device that supports Bluetooth 4.0 & iBeacon detection (e.g. iPhone 4S or newer).
  • The latest Raspberry Pi OS installed.

Optional but recommended:

  • A outward facing USB Bluetooth adapter for maximum broadcast range.
  • A dedicated battery pack so the Pi can be portable.

Install Requirements

We’ll install some packages to configure Bluetooth advertising and enable the iBeacon profile.

  1. Update packages:


sudo apt update

sudo apt upgrade -y

Install Bluetooth dependencies:


sudo apt install bluetooth bluez libbluetooth-dev libudev-dev

Install Node to run Bluetooth utilities:


curl -fsSL | sudo -E bash

  1. sudo apt install nodejs

Configure iBeacon Broadcaster

Next, we’ll download an open source Node.js iBeacon broadcaster and configure it.

  1. Get bleacon Node module:


git clone

cd bleacon

npm install

Edit bleacon.js file:


nano bleacon.js

Modify the broadcaster UUID, major, minor values:


var uuid = ‘e2c56db5dffb48d2ab060d0f5a71096e’;

var major = 1000; // 1 – 65535  

  1. var minor = 1; // 1 – 65535

  2. Save changes in nano with Ctrl + O and exit with Ctrl + X.

This gives your Pi a unique iBeacon identifier.

Start Advertising iBeacon

With software installed and identifier values set, start broadcasting as an iBeacon.


sudo node bleacon.js

The Raspberry Pi will now advertise itself as an iBeacon using Bluetooth Low Energy.

Detect iBeacon on Mobile Devices

To detect and interact with the Pi iBeacon, open an app on your mobile device that scans for Bluetooth LE devices.

On iPhone, you can use Apple’s Locate Beacon app. On Android devices, install a beacon scanner app from the Play Store.

When in proximity, you’ll see the Pi appear as an iBeacon advertising the identifier values configured earlier!

Now your mobile apps can start building location-aware experiences using the presence data.

Start iBeacon on Boot

To keep broadcasting the iBeacon signal automatically even after reboots, configure the bleacon.js script to run on startup.

  1. Install Upstart:


sudo apt install upstart

Create Upstart config file:


sudo nano /etc/init/bleacon.conf

Add file contents:


description “iBeacon Broadcaster”

start on runlevel [2345]

stop on shutdown


  export HOME=“/home/pi”

  echo $$ > /var/run/

  exec sudo -u pi /usr/bin/node /home/pi/bleacon/bleacon.js >> /home/pi/bleacon.log 2>&1

end script

Save and exit file, update init scripts:


  1. sudo update-rc.d bleacon defaults

Now every time your Pi boots, the iBeacon broadcasting will start automatically!

Monitor the background process with tail /home/pi/bleacon/bleacon.log.

Key Takeaways

  • Raspberry Pis can easily be configured to broadcast as iBeacons using built-in Bluetooth and the bleacon Node script.
  • Unique UUID, major, minor values identify each iBeacon’s transmissions.
  • Mobile apps scan for Bluetooth LE signals to detect proximity to iBeacons and trigger experiences.
  • Configuring the bleacon script as a service lets it run on every Raspberry Pi boot.


Setting up an iBeacon with a Raspberry Pi opens possibilities for creative location-based interactions powered by this inexpensive hardware. With apps that react when users come near the Pi iBeacon, you can send notifications, welcome messages, prompt check-ins, track analytics for foot traffic conversions, build navigation aids, automate IoT devices based on proximity, and more.

Have you created any neat iBeacon projects on the Pi? Share how you’re using this wireless technology for location detection and notifications!

Frequently Asked Questions

Q: Do I need additional hardware for the Raspberry Pi iBeacon?
A: Just a Raspberry Pi board with inbuilt Bluetooth or a USB Bluetooth dongle is required. An outward facing USB adapter provides maximum broadcast range. For a portable solution, battery packs can power the Pi.

Q: How far can the Raspberry Pi iBeacon detection range reach?
A: Up to 50 meters if using an external USB Bluetooth adapter. With the inbuilt adapter, expect 1-10 meters max. Placement, antenna orientation, receiver sensitivity, and obstacles affect range.

Q: Can the Raspberry Pi broadcast as multiple iBeacons?
A: Yes, with multiple broadcaster processes or Multi-Advertising processes you can broadcast as several iBeacons from one Pi. Each needs a unique identifier.

Q: Do iBeacons work for both iOS and Android devices?
A: Yes, both mobile operating systems can detect Bluetooth LE iBeacon signals in the background and trigger application experiences.

Q: Can Wi-Fi and iBeacons work together on the Pi?
A: Definitely, the Wi-Fi and Bluetooth radios don’t interfere. This allows building combined interactions with iBeacons for proximity and Wi-Fi for data transfers.

Q: Are there any security risks from iBeacons?
A: iBeacons just broadcast an identifier, they don’t transfer private data. Apps must respect user data and permission requirements for notifications. Disable iBeacon detection in device settings if unwanted.

Q: Do iBeacons require an internet connection to work?
A: No, iBeacons function independently via Bluetooth to communicate with nearby mobile devices. Internet connectivity allows enhanced functionality like updating iBeacon firmware remotely.

Q: Can the Raspberry Pi act as both an iBeacon and iBeacon scanner simultaneously?
A: Yes, using Bluetooth multiple advertising and broadcaster roles you can make the Pi both broadcast as an iBeacon and also scan to receive other iBeacon transmissions.

Q: Is specific iBeacon hardware required?
A: No, the iBeacon specification works with any BLE compatible hardware. Any central device including smartphones can function as an iBeacon with the proper broadcasting software.

Q: How long do iBeacon batteries last?
A: Using 2 AA batteries, an iBeacon can broadcast for up to 2 years before replacement. Low energy Bluetooth signaling makes this possible. Raspberry Pi iBeacons can run off battery packs.

Q: Can I turn a room or vehicle into an iBeacon with a Pi?
A: Yes! By placing a Pi iBeacon in a fixed location you can setup region monitoring and location-based interactions when users enter that area.

Q: Can I upgrade my Raspberry Pi iBeacon’s software remotely?
A: If the iBeacon Pi remains connected to Wi-Fi, you can remotely SSH into it and download the latest broadcasting software updates from the GitHub repository.

Q: Is any special hardware required for the Raspberry Pi iBeacon detector?
A: No, the Pi detector uses its built-in Bluetooth adapter to sniff iBeacon broadcasts. An external USB adapter can increase sensitivity. The Pi processes identifiers detected in software.

Q: Do I need multiple Raspberry Pis to setup wayfinding navigation with iBeacons?
A: No, a single Pi can broadcast as multiple iBeacons using separate broadcaster instances. Place strategically to cover a site, detect proximity in apps to navigate.

Q: Can the Raspberry Pi iBeacon values be changed on the fly?
A: Yes, with remote SSH access you can edit the bleacon.js file to adjust identifier values like UUID major/minor numbers. Restart the script to broadcast the updated identifiers.

Q: Can I use iBeacons and camera together on the Pi for tracking?
A: You sure can! Combine an iBeacon detector and Pi camera module to log images when users come in proximity range of places you have iBeacons deployed.


Leave a Comment