Keep your containers updated with What's up Docker?

Authentication

By default, WUD's web interface is accessible to everyone. To prevent network-wide access to view or trigger actions on your containers, define users and passwords. WUD will then require authentication. First, create a password hash compatible with the Apache web server's htpasswd tool. If you don't have the tool installed, just use OpenSSL:

$ openssl passwd -apr1 my_secret_password

The output resembles $apr1$xKTGamqS$x5d43GZTZfPDP4Sb3KK0p0, consisting of three parts separated by a dollar sign: the hash algorithm (apr1), the salt (a random string), and the hash value of the password and salt combined in Base64.

Next, add the username and the corresponding password hash as environment variables to the WUD container, while ensuring to duplicate each dollar sign:

environment:
      - WUD_AUTH_BASIC_KOAN_USER=koan
      - WUD_AUTH_BASIC_KOAN_HASH=$$apr1$$xKTGamqS$$x5d43GZTZfPDP4Sb3KK0p0

To define multiple users, just add more environment variables following the same process, adjusting the username accordingly.

Note that WUD operates over an unencrypted HTTP connection by default. For increased security, using HTTPS is wise. You can find instructions on enabling HTTPS and configuring a certificate and private key in WUD's documentation. Alternatively, run WUD behind a reverse proxy that handles HTTPS connections.

Alternatives to What's up Docker?

WUD is not the only open source solution for monitoring and updating container images. A popular alternative is watchtower [12], which focuses on automatically updating containers when a new image version is available, although it also offers update monitoring. However, it lacks a web interface. Another alternative, Diun [13], stands for Docker Image Update Notifier. It focuses on update monitoring, but also without a web interface. The choice of tool depends on your priorities, but WUD is the most versatile solution among these three.

Conclusion

WUD offers a flexible way to monitor your containers for updates of their images. This article only covers the basics, but extensive customization options are available. For example, you can override many of the program's general settings for specific containers, and you can assign different triggers to different containers.

Infos

  1. What's up Docker?: https://getwud.github.io/wud/
  2. Docker Hub: https://hub.docker.com
  3. selfh.st: https://selfh.st/icons/
  4. Simple Icons: https://simpleicons.org
  5. Material Design Icons: https://pictogrammers.com/library/mdi/
  6. Dashboard Icons: https://dashboardicons.com
  7. Font Awesome: https://fontawesome.com
  8. Crontab Guru: https://crontab.guru
  9. Docker remote access: https://docs.docker.com/engine/daemon/remote-access/
  10. "Sending push notifications with ntfy" by Koen Vervloesem, Linux Magazine, issue 297, August 2025
  11. Mailjet: https://www.mailjet.com
  12. watchtower: https://containrrr.dev/watchtower/
  13. Diun: https://crazymax.dev/diun/

The Author

Koen Vervloesem has been writing about Linux and open source, computer security, privacy, programming, artificial intelligence, and the Internet of Things for more than 25 years. He holds Master's degrees in Computer Science Engineering and Philosophy and is teaching Linux, Python, and IoT classes. You can find more on his website at http://koen.vervloesem.eu.

Buy this article as PDF

Download Article PDF now with Express Checkout
Price $2.95
(incl. VAT)

Buy Linux Magazine

Related content

  • Push Notifications

    If you host a lot of services on your home server, it helps to have them send you timely notifications. With ntfy, you can send push notifications to your phone or desktop.

  • Chore Conqueror

    Are you struggling to keep track of all your household chores? With its intuitive interface and advanced features, Donetick ensures you won't forget them.

  • Docker Open Source Developer Tools

    Docker provides the open source tools and resources for compiling, building, and testing containerized applications.

  • Plant-it

    To keep your garden and indoor plants alive, you must remember to water them on time, apply fertilizers, and more. Plant-it is a self-hosted garden companion designed to assist you in achieving these tasks.

  • Seafile 9

    Seafile offers file sharing and synchronization like Nextcloud and ownCloud, but its speed leaves the competition far behind.

comments powered by Disqus
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters

Support Our Work

Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.

Learn More

News