In a previous post I created a docker container for Goatcounter, a privacy-friendly analytics service. I wanted to submit it to the Unraid Community Apps repository so that others could easily install it. This post will cover the process of submitting a new app to the Unraid Community Apps repository. The first step I took was to install the docker container from Docker Hub. To do this, you can use the “Click Here To Get More Results From DockerHub” link.
Now the image I created earlier is available:
Community Apps will try and discover the ports and volumes that the container uses. In this case, it was able to find the port and volume that I had set up.
From here, Unraid drops you to the docker creation screen. I filled out the port and volume settings I needed and hit Apply. This allowed me to test the container and make sure it was working as expected.
From here I followed Squid’s instructions on this thread to submit the app. You’ll need to generate an XML file based on the container you just created. To do that, you need to follow a few steps:
- Turn Docker off under Settings -> Docker
- Turn on Docker Creation mode
- Turn Docker back on
- Go to the Docker tab and click Add Container
- Use the existing container as a template
- Fill out the defaults and click Save
You’ll be presented a text box with some XML in it. You’ll need to save that XML and make it available in a new Github repository.
⚠️ It’s important to note that this needs to be a separate repository from the container itself. This repository can store multiple Community Apps as well as your developer profile.
From here it’s mostly social work to get the app published. You’ll need to reach out to Squid with a link to your XML repository. You’ll also need to create a support thread on the Unraid forums, and then update your XML with that URL.