Step-by-step Omada Controller on MacOS via Docker.

Step-by-step Omada Controller on MacOS via Docker.

Step-by-step Omada Controller on MacOS via Docker.
Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:04:04 - last edited 2 weeks ago
Hardware Version:
Firmware Version: 5.13

Download and install "Docker Desktop" for your Mac (Apple or Intel as appropriate)

 

Open it up, and you should see something like this:

 

 

 

 

<< Paying it forward, one juicy problem at a time... >>
  0      
  0      
#1
Options
8 Reply
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:06:11 - last edited 2024-02-03 15:48:16

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 !

 

<< Paying it forward, one juicy problem at a time... >>
  1  
  1  
#2
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:22:56

Run the container:

 

 

<< Paying it forward, one juicy problem at a time... >>
  0  
  0  
#3
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:28:20 - last edited 2024-01-17 23:06:16

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

 

<< Paying it forward, one juicy problem at a time... >>
  0  
  0  
#4
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:33:48

 It will chug for a while as it creates the Omada Controller environment on your Mac:

 

 

<< Paying it forward, one juicy problem at a time... >>
  0  
  0  
#5
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 22:49:34 - last edited 2024-01-17 23:09:34

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:

 

 

 

<< Paying it forward, one juicy problem at a time... >>
  0  
  0  
#6
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-01-17 23:13:22

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!

<< Paying it forward, one juicy problem at a time... >>
  0  
  0  
#7
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-02-03 14:25:13 - last edited 2024-02-03 14:32:09

  @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?

  0  
  0  
#9
Options
Re:Step-by-step Omada Controller on MacOS via Docker.
2024-02-03 15:49:33 - last edited 2024-02-03 15:54:14

  @PappyChappy 

 

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.

<< Paying it forward, one juicy problem at a time... >>
  1  
  1  
#10
Options