How do I set the APN and bring a device online with a Hologram SIM (LTE-M or NB-IoT)?

Quick Answer: For most Hologram LTE-M and NB-IoT devices, set the APN to hologram, leave username/password blank, and make sure the modem is configured for the correct radio mode and bands. Then activate the SIM in the Hologram Dashboard, power up the device, wait for network registration, and open a data session. If the SIM is in Test Mode, you can validate the bring-up flow without paying for production traffic.

Why This Matters

If a device never comes online, the problem is usually not the app—it’s the connectivity setup. In the field, a bad APN, the wrong radio mode, or an inactive SIM can look like a hardware failure and waste hours on troubleshooting, truck rolls, and support escalations.

For LTE-M and NB-IoT deployments, the APN is the first gate. Get it right, and your device can attach cleanly, get an IP session, and start sending data. Get it wrong, and the device may register on the network but never move traffic.

Key Benefits:

• Faster commissioning: A consistent APN setup gets devices online sooner at the factory or installation site.
• Cleaner fleet operations: Standardized modem settings make large rollouts easier to automate with the Dashboard and APIs.
• Fewer support tickets: When the APN, SIM status, and radio settings are aligned, troubleshooting becomes much simpler.

Core Concepts & Key Points

Concept	Definition	Why it's important
APN	The access point name your modem uses to reach the cellular data network. For most Hologram SIMs, this is hologram.	If the APN is wrong, the device may never establish a usable data session.
Network attach	The step where the modem registers with the mobile network.	A device can attach successfully and still not have working data if the APN or context settings are wrong.
Data session / PDP context	The active packet data connection that lets the device send and receive traffic.	This is the moment the device becomes operational, not just “on the network.”

How It Works (Step-by-Step)

The bring-up flow is simple, but each step has to be right. LTE-M and NB-IoT devices are especially sensitive to modem configuration, so the best results come from setting the APN, confirming the SIM is active, and then verifying the session in the Dashboard.

1. Prepare the SIM and device:
   Confirm the device is compatible with Hologram, unlocked, and set to the correct radio technology. LTE-M and NB-IoT devices should be configured for the right mode before you try to bring them online. In the Hologram Dashboard, make sure the SIM is active and not still sitting in a pre-deployment state.

2. Set the APN in the modem profile:
   For most deployments, use hologram as the APN. On many modules, that looks like this:

   AT+CGDCONT=1,"IP","hologram"
   

   Your module may use different commands, but the goal is the same: define the APN before the modem opens a data session. In most cases, you do not need a username or password.

3. Attach, open the session, and verify connectivity:
   Power up the modem, let it register, and then bring up the packet data context. A typical flow looks like this:

   AT+CFUN=1
   AT+CGATT=1
   AT+CGACT=1,1
   

   NB-IoT can take longer to attach than LTE-M, so don’t assume failure after a few seconds. Once the session is active, confirm the device in the Hologram Dashboard and check for real-time usage or status updates. At scale, this is where the Dashboard and API integrations save time.

Common Mistakes to Avoid

• Using the wrong APN:
  If the modem still has a carrier-specific APN from previous testing, replace it with hologram before deployment.

• Forcing the wrong radio mode:
  LTE-M and NB-IoT are not the same as consumer LTE. Make sure the module supports the right technology and bands for the site.

• Expecting NB-IoT to attach instantly:
  NB-IoT sessions can be slower to establish. Give the modem time, and check signal, registration, and SIM status before assuming the hardware is bad.

• Skipping Dashboard verification:
  If the device “looks online” locally but never shows traffic in the Dashboard, you may have an APN or session issue—not a device defect.

Real-World Example

A team deploying remote energy sensors on rooftop solar sites preloads the modem with the hologram APN in the factory, then ships each unit in Test Mode. When installers power up the device in the field, the modem registers, opens its data session, and appears in the Hologram Dashboard with real-time visibility. If one site has weak coverage or slower NB-IoT attach times, the ops team can see it quickly and adjust without sending someone back onsite.

Pro Tip: Bake the APN into your firmware or modem profile before manufacturing. That way, your first power-on in the field is a connection event, not a configuration exercise.

Summary

To bring a Hologram LTE-M or NB-IoT device online, set the APN to hologram, confirm the SIM is active, configure the modem for the right radio mode, and open a data session. The most common failures are simple: wrong APN, wrong network settings, or assuming the attach process will be instant. Once the modem is configured correctly, you get the operational benefits Hologram is built for: simple activation, real-time visibility, and predictable fleet rollout.

Next Step

Get Started