Guide to Installing Omada Software Controller on Raspberry Pi 4
This brief post, which can hardly be called comprehensive, is my contribution to installing the Omada software controller on a Raspberry Pi 4. For Dummies. Like me.
The disclaimer is that I've only gotten it running and haven't yet migrated over my settings from the laptop that my main instance currently runs on. I also have almost no idea what I'm doing in Linux and just want things to work.
Here's what worked for me:
- Get a Raspberry Pi and just order it with an SD card pre-loaded with Raspbian. One less thing to deal with.
- Install Docker. You can Google how to install Docker on a Raspberry Pi. Not sure which website I followed but this one seems good. Not that I took the lazy approach of not setting up an account for a non-root user. https://phoenixnap.com/kb/docker-on-raspberry-pi
- Install Portainer. To deal with Docker. https://pimylifeup.com/raspberry-pi-portainer/
- Now you'll need to find the software image for the Omada controller and pull it into Docker by using Portainer. Don't get lost in the weeds of trying to use Github for this like I did. Use Portainer's onboard support for Dockerhub and pull down the same image made by the same guy. Two important points:
- By using the containerized version of the software (which is what you're doing with Docker if you're following my steps) you can avoid having to deal with Java versions and Mongo DB. This is a potential pitfall of trying to coordinate all the dependencies yourself. This guy solved that problem with a packaged solution.
- You want to pull the down image using "mbentley/omada-controller:latest-armv7l". You could use other tags but it seems that the version that will run on Raspberry Pi 4 needs to be for the armv7l architecture. Not arm64, etc.
- Now you need to use Portainer to create a Container using the image you just pulled. This is pretty straightforward if you follow the documentation.
- Now you should be able to start the container and it should run. The Omada controller is now running on your Raspberry Pi.
What I need to do next is to learn about volumes and how to store data from the software so, if the Pi shuts down, my network settings don't go with it.
Hope this saves someone a few hours...
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
@HomeAdmin how can I get APC in Bangladesh? I found MingCh and Sako on this website: https://smartpowerltd.com/best-online-ups-in-bangladesh/. Can it be applicable?
- Copy Link
- Report Inappropriate Content
I didn't like this guide at all... it's not really helpful. I've wrote a much simpler one below, which uses all default packages available and the host functionality for docker (so you don't have to mess up with ports) and the superuser.
1) Install Ubuntu Server on Raspberry Pi 4. On the network-config step, set a static IP for your Raspberry Pi.
2) Once the server is running, update the package information and upgrade older versions:
# sudo apt update && sudo apt -y upgrade
3) Install docker
# sudo apt install docker docker.io
4) Run the container
# sudo docker run -d \
--name omada-controller \
--restart unless-stopped \
--net host \
-e MANAGE_HTTP_PORT=8088 \
-e MANAGE_HTTPS_PORT=8043 \
-e PORTAL_HTTP_PORT=8088 \
-e PORTAL_HTTPS_PORT=8843 \
-e SHOW_SERVER_LOGS=true \
-e SHOW_MONGODB_LOGS=false \
-v omada-data:/opt/tplink/EAPController/data \
-v omada-work:/opt/tplink/EAPController/work \
-v omada-logs:/opt/tplink/EAPController/logs \
mbentley/omada-controller:5.3
5) Done. Access it on browser: https://server-ip:8043
6) Optional: install portainer to check server logs. After commands below, access portainer on https://server-ip:9443
# sudo docker volume create portainer_data
# sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce
- Copy Link
- Report Inappropriate Content
Information
Helpful: 9
Views: 37497
Replies: 22