hi guys and welcome back to another ibra corp video today we're going to be discussing getting
a application published to the community application store in unraid this is people
that you might have got your own template working and you want to publish it out to other people so
everyone else can use and benefit from it just like my orthelia template for example
so today i'll be showing you how to do that a quick shout out to everyone who's liked and
subscribed we really appreciate your support if you haven't subscribed yet please do so it really
helps the channel out and we greatly appreciate it as usual let's just get stuck into it
so today we're going to be installing a container called pwm
pwm is a open source password self-service application and it reads from ldap to allow people
to manage their own accounts without bothering an administrator basically which is a really cool
application i think it took me a while to get it going at first and to get my head around using it
so in this video we're not going to cover that too much it's going to be
more focused on getting a application published to the app store so people can install it
i will make a separate video on how to actually configure pwm to get it to work
but in order to get it to work we also need a ldap back-end already running so i'm going to
create a future video for free ipa a lot of people have asked me about that so it's on my list to do
we're going to get a free ipa server running on a vm in unraid and then have pwm as the front
end so i can show you right now already use pwm and i've got it as a portal.ibracorp.io address
i do actually have a few members of ibracorp and managing their passwords now that we're using ldap
i just wanted it to be a lot easier for them so as you can see this is sort of like a portal they can
sign into and they can have a look at their own account change their password update their profile
you know information that might need to be changed they can all manage it themselves
which is fantastic so i've got this working on my server at the moment i installed it using docker
hub and i've got a video about that already out how to install something from docker hub
so now i've liked it i like what it looks like and i want to get it out to other people so they
can use it so we're going to go through how to get that going so these are the official instructions
to get an application published out onto the ca store or community application store in unraid
as you can see there's quite a few steps but it really doesn't take long we just have to make
sure that we get everything right and we do it nice and clean so i'll leave this up for a second
the link will also be down in the description of course but i'm going to move it off to the
side and we're going to follow it together so we're back in our unraid our brand new unread
system over here the first thing you want to do is make sure your array is off you want to make
sure your array is offline so you can see mine is offline at the moment and if i just scroll down
under the main tab you'll see the array operation and it's stopped okay so if yours has started just
make sure it's stopped also keep in mind that if you have containers running vms running anything
like that they're also going to be stopped as well so i recommend you make sure you
gracefully shut everything down first then come back and stop the array go to settings docker
hit the advanced view in the top right corner here authoring mode
if set to yes when creating editing containers the interface will be present with some extra
fields related to template authoring so we need to turn this on that's the first step so we'll
click yes and we'll hit apply so now that that's done we can start up our array again
and the array has been started head over to docker tab and now we're ready to get our hands dirty
so the first thing you'll need to know is what it is you actually want to create a
container for if you haven't watched my video on how to create a container from docker hub i
recommend you watch that video first because it's going to instruct you on what details to put in
when creating a container so we'll go and click add container which is the second step and here
you're faced with a empty template basically so in the name we're going to call this pwm
overview i always like to just take the official overview
from whether it's docker hub or wherever else you're getting the information from
so in this case we have pwm here on docker hub just put it in there
the repository this is the repository
with the categories so you need to make sure you pick these correctly because this is what will
help filter in the ca store so for the categories we will say pwm is a we'll say pwm is a security
application the support thread so if again you're reading the instructions that i've mentioned at
the start here it's really recommended that you have a support thread created on the unraid forum
so as you can see here here's our support thread that we've created on the unraid forum
and we created it first before we done anything else to have it ready and if we just scroll down
you can see everything that i've put in there for my templates that i've created and
that's just so that's easier for someone that needs support to find all the links they need
so for the support link we will take this head back to unraid put the support thread in there
the project page if you have a github project page or if you want to link the official github
project page for the project that's probably the best thing to do so we'll just take this
which is the official github page here for pwm put that in there
donation text so we're just gonna put this for example
and a donation link so put the link in for your where you'd like to receive donations
the docker hub url so we know that the url is just this one here put that in there for the icon url
you can put any link to the icon that you think is relevant if there's an official icon it's always
recommended to put that of course i couldn't actually find one for pwm that looked sort of
attractive i suppose so i found one that i thought would look best and i've uploaded that to img
you can upload that to your repository put that link in there you can feel free to use
that link if you like as well for the web ui this is what you'll need to put in there
the only thing you'll need to change is the port if if those ports are already in use so this port
is not in use for me and i'm gonna and i want to use that port so we're gonna use that one
we don't need any extra parameters mapped we don't need a post argument map
we'll leave bridge as itself because not everybody might have their own custom
docker network so we'll just leave that as bridge you have to remember when you're doing this you're
gonna if it's going to be published on the ca store what's the most general and working config
that you can have so that somebody doesn't have any problems later on so we want to try and keep
it sort of as bare as possible but to have the basic information that we need the only other
thing that will map and the reason why we'll map it is if you go back to the docker hub
page for pwm that we're using here by f judith we can see the docker run command that it needs to
operate and it's really not much of a command the only thing that you need to really map is a port
that's it so the official port that the container uses is 8080 and the host is set to 8080 here
but you can set that to whatever in our case as you can see up here we've set it to 8282
which means we want ours to be a282 so we'll click add another port variable down the bottom
hit the port no need to put a name we can simply put the container port as eight zero eight zero
and our host port is eight two eight two
hit add that's it now in the steps in the official steps for creating the docker templates
i just bring it back over so it says it's fill out all the relevant information including the
advanced section note that you do not need to fill out host volumes it is okay however to fill out
the host ports so all we've done is put the host port in there so we'll go ahead and click save
now we're presented with an xml which is great so the next step is copy and
paste the entire xml that appears to an appropriately named xml file somewhere
well no problem so we'll just bring over notepad plus plus here
paste it there we've created a folder here on our desktop just called we just named xml and we'll
call this pwm and we want to save it as a xml file we've got extensible markup language here
hit save if you don't use notepad plus plus i recommend that you do just makes it a bit easier
when you're modifying things that have certain formatting so you can see as soon as we save
that as an xml it's gone and re-read it again and highlighted things that show it as a xml
so we've created the xml the next step now is publishing it to the app store so what you need
to do is create a github repository so this is my github and i've got a few repositories
the one thing i learned when creating the repositories is you don't need to create
a separate repository for every single thing if you're just creating templates and it says
it here as well i'll just bring it back over use a separate repository for your xml files
okay but then it says if you have multiple templates put them all into the same repository
so as you can see here we've got unraid templates i've got the author folder and i've got the
jira service desk folder so just to correct myself from earlier i've renamed the folder
to pwm and i renamed the file to pwm all in lower case all right just so we have something
uniform there so just so you know we've renamed those things there now the reason why is because
we're going to go ahead now and put the whole folder in all right now it's not hard to create
an account with github it's really easy so just create an account create a repository
and up here you'll see that new repository in the top right corner we won't need to put anything
here leave it to the master branch click commit there you go now if we open up pwm there's our xml
file if we go back to the instructions the next step is to drop squid a personal message asking
for it to be published with a link to the github repo we have our xml it's up in our repository
everything looks good we've created only one repository so that our templates can live there
so this is the link to the repository make sure you copy that
then the next step was to click squid a message and let him know
and that way he can check it out and then add it to the app store so on unraid we've got
our account here on the forum go to messages compose new so we've written out a message to
squid there we've just basically explained we've created new xml and we have a repository where
we're keeping our xmls to live we've let him know here what it is we're actually trying to publish
and we've asked you know what just let us know if there's any issues that need fixing
squid is a busy busy man so try and keep it brief and just straight to the point
like i said don't create multiple different repositories if you supply him with the one
repository and he's happy with your work it will be automatically added to the ca store and again
it says it here after you have a repository added i do not need to know about any new xmls being
added community apps and more to the point the app feed will handle all changes to the x amounts
automatically every two hours so there's an extra link as well that we've been provided and if we
just have a quick read through that there's some extra tags that you can go ahead and put into your
to your xml so if you have a base image what type of branch you know the date the beta categories
overview now most of this stuff was done when we originally created a template anyway but these are
additional tags that you can put in we just come back and that's pretty much it so if it's approved
it will be up in the app store within two hours i mean that's pretty handy right it's just gonna go
up there and anybody that needs help they can just ask for it straight away into your support thread
so after you receive confirmation or any sort of reply from squid or any of the administrators or
moderators double check that it's up there and it looks correct if it's not then just
get in contact with them and let them know but that's pretty much how to get something up there
for everyone else to use so just keep in mind that if you have a docking container that has a
couple extra fields that need to be mapped it says here that you do not need to fill out host volumes
okay just the ports and they would recommend against filling out any host paths let's say you
filled all this out if the docker requires a path mapped in which case it doesn't but if it does
put the path for the container path side only so let's say this was the container path don't
map the host path okay you just leave it like that and the person that receives it
on the other end can then apply it alternatively you can map it if it's something like app data
you know that consistently most people will have it in app data anyway so you would want to
map there and then apply or save it so that should pretty much be about it so now we basically wait
and hopefully it'll be up on the app store if it's up by the time this video comes out feel free to
install pwm yourself and see if it works for you like i said a future video we'll be installing
free ipa which is a ldap open source system and it's designed by the red hat linux team
i use it myself and it's fantastic and i highly recommend it especially if you're going to have
multiple users or you just want to wrap your head around ldap and how it works outside of a windows
active directory environment you know i work in 9t my whole life i've basically used active
directory so i got to try a different tool and i learned a lot from it so even if you think that
you're never going to have enough members or users that would need such a thing and you
just want to learn it why not you know upskill yourself i've had some people comment this is
kind of too advanced and you know what sort of need there would be for it my response to that is
it's not my place to tell you what isn't isn't what you want to install and that's the beauty
of open source there's no limitations hey if you want to install an enterprise level ldap
sure go for it upscale yourself and learn something new that's that's the real point
of life i think anyway so if you enjoyed the video please remember to like and subscribe
it really helps me out and i hope i can see you in the next video thank you very much
you