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:
Here you'll see three things:
- Security Code -- here:
- Serial Number -- here:
- MAC NR -- here:
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:
Security Code is trivial, just enter the security code found on the bottom of your hub.
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
.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
- 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:
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..., select
- 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 Addressand your
Subnet Maskon the right side of the window
10.0.0.10and my subnet mask is
255.255.255.0. That means that I am in the same local network as all devices with IP addresses ranging from
If, however you found out in step 4.1 that your hub has the IP address
10.0.1.11, 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: https://www.wikihow.com/Ping-on-Mac-OS
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 10.0.0.255 -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
10.0.0.10 so I'll use
10.0.0.255 and I will get the following result:
PING 10.0.0.255 (10.0.0.255): 56 data bytes 64 bytes from 10.0.0.10: icmp_seq=0 ttl=64 time=0.115 ms 64 bytes from 10.0.0.244: icmp_seq=0 ttl=128 time=0.346 ms 64 bytes from 10.0.0.151: icmp_seq=0 ttl=64 time=0.958 ms 64 bytes from 10.0.0.150: icmp_seq=0 ttl=64 time=1.002 ms 64 bytes from 10.0.0.10: icmp_seq=1 ttl=64 time=0.033 ms 64 bytes from 10.0.0.244: icmp_seq=1 ttl=128 time=0.269 ms 64 bytes from 10.0.0.150: icmp_seq=1 ttl=64 time=0.496 ms 64 bytes from 10.0.0.151: icmp_seq=1 ttl=64 time=0.998 ms 64 bytes from 10.0.0.10: icmp_seq=2 ttl=64 time=0.193 ms 64 bytes from 10.0.0.244: icmp_seq=2 ttl=128 time=0.345 ms 64 bytes from 10.0.0.150: icmp_seq=2 ttl=64 time=0.509 ms 64 bytes from 10.0.0.151: icmp_seq=2 ttl=64 time=1.075 ms 64 bytes from 10.0.0.10: icmp_seq=3 ttl=64 time=0.104 ms 64 bytes from 10.0.0.244: icmp_seq=3 ttl=128 time=0.247 ms 64 bytes from 10.0.0.150: icmp_seq=3 ttl=64 time=0.426 ms 64 bytes from 10.0.0.151: icmp_seq=3 ttl=64 time=1.486 ms 64 bytes from 10.0.0.10: icmp_seq=4 ttl=64 time=0.034 ms --- 10.0.0.255 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:
This leaves me with:
? (10.0.0.10) at 0:0:ca:1:2:3 on en0 ifscope permanent [ethernet] ? (10.0.0.110) at 68:b8:3d:22:1c:42 on en0 ifscope [ethernet] dsldevice.home (10.0.0.138) at 22:12:bb:a0:3d:fd on en0 ifscope [ethernet] ? (10.0.0.150) at b4:12:23:5a:d3:6f on en0 ifscope [ethernet] ? (10.0.0.151) at df:3c:08:d9:ed:2c on en0 ifscope [ethernet] gw-0a1b2c3d4e5f.home (10.0.0.244) at 0a:1b:2c:3d:4e:5f on en0 ifscope [ethernet] ? (10.0.0.255) 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.
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.