Knowledge Base Step-by-step Omada Controller on MacOS via Docker.
Download and install "Docker Desktop" for your Mac (Apple or Intel as appropriate)
Open it up, and you should see something like this:
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
In the search box at the top of the Docker window, type 'mbentley', and then download the Omada Controller image as shown below:
(the default tag at time of writing was 5.9-chromium, by choosing beta-chromium you will get 5.13.30 or later)
NOTE: You can only use the -chromium images if you have Intel based Macs. If you have a newer M1 or M2 based Mac, then
please use the standard :latest tag as that will support the ARM64 architecture of the Mx chips. Thanks @PappyChappy !
- Copy Link
- Report Inappropriate Content
Run the container:
- Copy Link
- Report Inappropriate Content
Give it a name and change the port mappings (host networking is only supported on Linux hosts, so we must port-map here):
and the logs will start to spin...you'll see the ports mapped as below
- Copy Link
- Report Inappropriate Content
It will chug for a while as it creates the Omada Controller environment on your Mac:
- Copy Link
- Report Inappropriate Content
Some 5min later (or longer if your CPU is pokey) you'll see this in the logs:
and your Containers view will show stats properly:
- Copy Link
- Report Inappropriate Content
You can now point your Mac's browser at https://localhost:8043 or https://127.0.0.1:8043 or https://your.macs.ip.address:8043
(you will have to acknowledge unsafe and proceed)
You can now proceed to setup up your WAN and LAN settings.
Enjoy!
- Copy Link
- Report Inappropriate Content
@d0ugmac1 This guide is excellent and should help anyone looking to set up docker on MacOS, thank you for posting. I am confused about using the "chromium" version of the image; when I tried using that is gave me an error that it was the wrong architecure (amd64) vs. what the mac can natively use (arm64) and to expect performance issues. I had always used the non-chromium image and have never seen those errors until I followed your guide. I use docker compose and the tag "beta" FYI. I didn't do it through the docker desktop interface and do notice that there doesn't look like just a generic "beta" tag available there, maybe it is the same thing?
- Copy Link
- Report Inappropriate Content
Thanks for this correction (I've edite post#2 above). For M1 or M2 based newer Macs, the ARM64 architecture is not supported by the -chromium builds (AMD64 (intel) only). So pick the :latest or :beta build minus the chromium tag.
- Copy Link
- Report Inappropriate Content
Information
Helpful: 0
Views: 4168
Replies: 8
Voters 0
No one has voted for it yet.