for Trådfri


How to setup your Trådfri hub

The following section guides you how to set up and register your Trådfri Hub with Illuminator. Usually it should be an easy and straightforward process. If, for some reason, you cannot find your hub please read and follow these steps carefully.

STEP 1: Firmware Update

Update your Trådfri Hub and your Trådfri lights to make sure you are using the latest firmware versions. To do this open your IKEA Trådfri App on your iPhone or Android phone and select Settings > Trådfri version and click check for updates. When you see all your devices are updated to the latest version you are good to go. As of 2019-01-13 the versions are 1.4.15 for the hub and 1.2.217 for the lights.

STEP 2: Look at your hub

Turn your hub upside down:

This is not an actual hub, all numbers are fake and so is the QR-Code!

Here you'll see three things:

  • Security Code -- here: edoCytiruceSruoY
  • Serial Number -- here: 0a-1b-2c-3d-4e-5f
  • MAC NR -- here: 0a1b2c3d4e5f
    Conveniently the serial number is the same as the MAC address of the hub.

TIP: To avoid typos you can also use the QR-Code like the Trådfri app does. Use any app for iOS or Android that scans QR-Codes and read the tag. The code contains the serial number followed by a comma and the security code:


STEP 3: Add these numbers to Illuminator

Now its time to configure Illuminator - open the menu Preferences > Setup:

The field Security Code is trivial, just enter the security code found on the bottom of your hub.

The field Hub host name / IP needs the hub's host name as advertised on the network, or alternatively its IP address. It's better to try with the host name first, as an IP address can change. As indicated in the dialog box, the host name is gw- followed by the MAC Nr (i.e. the serial number without the dashes).
So in my case I would have gw-0a1b2c3d4e5f. This is what I will enter in the text field.

However, on my network this alone would fail! This is because my router adds all devices in the local area network (LAN) to a special top level domain. Usually .home or .local are used. My router uses .home, so I have to append the domain to get a complete host name:


Normally you are done now, and Illuminator will find and connect to your hub. If not, proceed to the next step.

STEP 4: Troubleshooting

Some things could go wrong. Here is what I can thing about right now:

  • you have an old firmware version of your IKEA hub -- did you really do STEP 1?
  • your hub has a different name and doesn't follow the gw- + serial scheme.
  • your top level domain is not .home or .local.
  • are you sure your Mac and your hub are on the same network and can find each other?

STEP 4.1: Look at your router

The next logical step would be to inspect your local network. The easiest way is to log in to your router (e.g. your modem from your internet provider). Using the router's web interface, try to find a device that has a MAC address that matches the one found on the bottom of your hub. The router may choose to show MAC addresses using colons instead of dashes (like this: 0a:1b:2c:3d:4e:5f).

I cannot give detailed instructions here because there are zillions of routers out there. But when you have found your device you will also likely see a host name, which you can enter in the Illuminator setup dialog.

If it doesn't give you a host name you will certainly see an IP-address such as:

This is what you can use instead of a host name as well. While you are at the router's web interface, just make sure to tick a box always use the same IP address for this device (or something similar) to make sure the hub's address doesn't change between reboots.

STEP 4.2: Find out what network your Mac belongs to

Do the following:

  • from the Apple menu, select System Preferences...
  • in System Preferences..., select Network
  • in the left of the network window that opens, click the name of your active connection (e.g.: Wi-Fi, AirPort, Ethernet, Built-in Ethernet)
  • you will find your IP Address and your Subnet Mask on the right side of the window
My IP is and my subnet mask is That means that I am in the same local network as all devices with IP addresses ranging from to

If, however you found out in step 4.1 that your hub has the IP address, it means that it is in a different network and you might not be able to reach it.

To find out if you can establish a connection to a specific IP address you can use ping. A good explanation on how to achieve that on a Mac can be found here:

If it turns out that you cannot ping your Trådfri hub from your mac, you need to check your router and local network configuration to fix that.

STEP 4.3: Unleash the Console

If you got this far it will not hurt to launch the Terminal app to scan your local network. You can launch the app from /Applications/Utilities/ or use Spotlight and Command + Spacebar.

In the window that opens enter the following ping command (always finish each command with the enter key on your keyboard):

ping -c 5

You need to use your network broadcast IP address here. The broadcast IP typically is your Mac's IP with the last number set to 255. My IP is so I'll use and I will get the following result:

PING ( 56 data bytes
64 bytes from icmp_seq=0 ttl=64 time=0.115 ms
64 bytes from icmp_seq=0 ttl=128 time=0.346 ms
64 bytes from icmp_seq=0 ttl=64 time=0.958 ms
64 bytes from icmp_seq=0 ttl=64 time=1.002 ms
64 bytes from icmp_seq=1 ttl=64 time=0.033 ms
64 bytes from icmp_seq=1 ttl=128 time=0.269 ms
64 bytes from icmp_seq=1 ttl=64 time=0.496 ms
64 bytes from icmp_seq=1 ttl=64 time=0.998 ms
64 bytes from icmp_seq=2 ttl=64 time=0.193 ms
64 bytes from icmp_seq=2 ttl=128 time=0.345 ms
64 bytes from icmp_seq=2 ttl=64 time=0.509 ms
64 bytes from icmp_seq=2 ttl=64 time=1.075 ms
64 bytes from icmp_seq=3 ttl=64 time=0.104 ms
64 bytes from icmp_seq=3 ttl=128 time=0.247 ms
64 bytes from icmp_seq=3 ttl=64 time=0.426 ms
64 bytes from icmp_seq=3 ttl=64 time=1.486 ms
64 bytes from icmp_seq=4 ttl=64 time=0.034 ms

--- ping statistics ---
5 packets transmitted, 5 packets received, +12 duplicates, 0.0% packet loss
round-trip min/avg/max/stddev = 0.033/0.508/1.486/0.421 ms

What this command essentially does is to kindly ask all devices in this network to report back to me. So I should get a number of all IP addresses in my LAN here. However this might not be the case, since some devices choose not to answer. Luckily the IKEA Trådfri Hub does, so it is in the list.

But which of the IP addresses belongs to the hub? To find out I will enter another command next:

arp -a

This leaves me with:

? ( at 0:0:ca:1:2:3 on en0 ifscope permanent [ethernet]
? ( at 68:b8:3d:22:1c:42 on en0 ifscope [ethernet]
dsldevice.home ( at 22:12:bb:a0:3d:fd on en0 ifscope [ethernet]
? ( at b4:12:23:5a:d3:6f on en0 ifscope [ethernet]
? ( at df:3c:08:d9:ed:2c on en0 ifscope [ethernet]
gw-0a1b2c3d4e5f.home ( at 0a:1b:2c:3d:4e:5f on en0 ifscope [ethernet]
? ( at ff:ff:ff:ff:ff:ff on en0 ifscope [ethernet]

Look for the serial number of the Trådfri hub in the list above (replace the dashes - with colons :).
Voilà! I got my hub with the host name gw-0a1b2c3d4e5f.home and the IP address

STEP 4.4: Reset all of Illuminator's settings

You can also reset all off Illuminator's settings via the command prompt. This may be necessary in order to "forget" and set up a hub once again after it has been comfigured. All settings are stored under the user's home directory and therefore persist after a new installation of the program!

First exit the Illuminator application.

Launch the Terminal app as described under step 4.3. In the terminal window enter the following command to search for the location of the application settings:

find ~/Library -name 'at.shsoft.Illuminator.plist' 2&>/dev/null

Be patient, it may take a while... On my system the settings are found under the following path:


Store this path in a variable:


Finally enter the following three commands:

defaults delete $CFG tradfri.identity
defaults delete $CFG tradfri.ip
defaults delete $CFG tradfri.preSharedKey

You can now start Illuminator and setup your hub again.

STEP 5: Help, I'm lost!

If you have done all of the above and are still having troubles feel free to contact me. I will not help you to set up your local network at home but most things are easy to solve and to figure out.