Homebox - Open Source, Self hosted Inventory and Asset Management for your home or small business!

foreign [Music] Source Advocate and I'm back with another video and today I'm going to talk about home box now this is a home Inventory management asset management system it's pretty cool and pretty awesome and honestly I don't think it has to be tied just to your home I think this could be used very easily for a small business maybe even a medium-sized business for Asset Management we're going to go through how to get it installed and set up and then we'll talk about the user interface and kind of some things about it but it's really cool it's still pretty early in development they still claim it to be kind of a beta stage but it looks pretty solid and they've got a demo that you can try out if you don't want to go install it yourself you can just kind of go check it out and see what's there but I always like to install things myself and see how well it runs on my Hardware make sure everything's running right and I know you guys do too so we're going to get into the installation of homebox right after this I want to say thank you to all of my subscribers and all of my patrons over at patreon seriously you guys make this so worth it for me to do these videos every week I really truly enjoy it and I just can't say thank you enough if you're enjoying these videos subscribe let YouTube know that I'm doing a good job by subscribing to the channel plus you'll get notified when I have new videos coming out and finally if you're enjoying what I'm doing give it a like just click on that thumbs up and that way YouTube knows that you like it and they'll pass it along to other people that might enjoy my content as well I really appreciate it thank you again let's get started so I've been asked a lot about Inventory management systems through the comments through my discus.opersources awesome.com rocketchats instance through telegram through email and I've kind of put it off because I wanted to find several different options to be able to cover over a few different weeks for you guys so that you would have some things to look through and kind of make up your own mind about what fits for you because there's actually several really good open source Inventory management systems out there and it really just depends on your use case as to what you're going to need or want so I'm going to be talking about homebox today but in the future we're going to cover snipe it or snipe it I believe is how you're supposed to say it and then there's one called binner that looks really cool and I've got a couple of others lined up that I want to check out as well so over the next few weeks and they won't be consecutive or anything I'll be covering those so you guys can check them out and see what you think and you can go out and get the one that you like the best or maybe you want to run a couple of them maybe you want one for home and one for your business who knows right there's all kinds of really great opportunities and aspects to inventory and asset management So today we're going to cover home box and we're getting into the installation right now so as you come to the homebox page if you actually just click on the quick start you'll get taken to this page which has some Docker information and it's actually as simple as this Docker Command right here to get it up and running right away now I'll say if you want to do a few extra things he's got some other environment variables that you can use to configure the system when you run the docker compose command you can change the port that it runs on so if you've paid attention to any of my videos you know that I tell you when you set up the port mapping never change the right side well in this case he's actually giving you the ability to change the right side port if you want to I don't know why you would want to it runs inside of a container it's not going to have any important you know configuration issues so I would leave it as it is but just know you do have that capability for the first time I think since I've talked to you guys you've got the option to change the right side port in the port mapping if you just really been wanting to do it if you're the kid that always has to push the button because it's there then this is your shot so this one that says hbox options allow registration so it's defaulted to true you don't have to set this anywhere and set it to true it's defaulted to true if you set it to false then people cannot register for your instance that's probably what I want but I tried this earlier and I wanted to make sure that I wasn't misunderstanding something so I turned it off before I had even created my admin user and yeah there's no registration so if you haven't set up your first user and you've already turned this off you don't have a way to set up your first user so initially you want to run it with this enabled set up your initial user then go back and rerun the docker compose command with this in there and just set it to false just add a line right into this one make sure you space it correctly remember yaml is space dependent but get it set up and then set it equals false and then just run Docker compose up Dash D again and registration will be gone from the login screen and nobody can register after that so there's a whole bunch of these if you want a bigger upload size than 10 megabytes you can set that here but 10 megabytes is a lot so even if you had a spreadsheet that you're importing a 10 megabyte spreadsheet is a really really big spreadsheet I mean massively huge spreadsheet now he tells you what you can import and what you can't import he's got a really great document that shows you what you can and can't do with Imports so definitely check that out and I'll kind of point it out as we go through the video as well but yeah a few things for you to kind of check out and understand about what you're using and what you're setting up here so again changing the port numbers just all kinds of different things if you want to set this to a different schema you can but we're going to use a reverse proxy so we can give this thing a domain name and everything like that so let's get into the install because I'm sure you're tired of hearing me acting but I thought it was valuable to kind of point out some of this information down here so I'm just going to highlight this as is I'm going to copy it I'm going to go over here and open up my terminal so I'm already logged into my server if you're not logged into your server if you're not working on the server you want to use then make sure you SSH that server first but I've already done that so I'm ssh in and now I'm going to do a simple command of mkdir- P I'm going to type in Docker and then slash home box what this command does is it says make the directory Docker home box and what it tells us is if we don't even have the docker directory yet it will create it but if we already have a directory called Docker it'll just leave it and then it'll say okay do you have a directory name home box no okay let me create that inside of your Docker directory if you don't have either one of these it creates them both so it's a really nice command it makes it very easy so we're going to hit enter now I'm going to CD into that home box directory that we just created and I'll do an LS you can see that it's empty so I'm going to do Nano Docker hyphen compose we want to make sure we spell that right dot yml just like this so Nano Docker hyphen compose.yml that's going to open up our Nano editor now you can right click and do paste you can also do Ctrl shift and v like Victor and that will paste so it just depends on how you want to kind of do this but you can 100 do it by using a right click if you want to now I've got my terminal really big because people on the phones it's hard to see sometimes what I'm doing so I want to make sure that you can see what's happening all right we've got a version 3.4 Docker compose file we've got our services listed in its home box now this is going to use the image from GitHub uh container repo I think is what this stands for I can't remember and then it's a DOT IO and it's going to pull this guy's image and its home box and its latest so it's going to pull the latest version that's available at the time when you run it the container name is going to be home box restart as always so basically if you're if your server restarts home box will restart with it what I like to do is I like to do unless stopped um that just I don't know it just makes me feel better that I can stop it and it's not going to restart on its own I'll have to tell it to restart because then I can go do maintenance or do something like that and I don't have to worry about it restarting so if I stop it for some reason and then I shut down my server and rebooted it it doesn't just come back up on its own it'll come back up if I go tell it but if it's running and I have a power outage and my server reboots it will come back up so I really like unless stopped it's a really good option so here's your environment hbox log level is info I'm sure you can change this to debug and things like that but for now we're going to leave on info hbox log format is text that's fine and then again the upload size Max is 10. so we're just going to leave that at 10 I think 10 megabytes is massive I don't think we need to have anything bigger than that if you're finding for some reason that you are having issues you might come back and change this and then restart the docker container as we move down he's got one volume set up which is home box data and I want to change this to dot slash homebox data which means in the directory where this Docker compose file lives create this folder and then map that to the data folder inside of the container so everything for homebox stays inside of my Docker homebox folder and it's easy for me to back this up which I really love so this is the reason I put the dot slash up here for ports he's mapping 3100 on the host to 77.45 inside of the homebox container now if your host is already using Port 3100 for something else you should change this left side okay now remember I always say don't change the right side unless you know what you're doing just remember he gave you an option to to create an environment variable up here and change that Port if you want to but I would say leave it at 77.45 unless you just have a really really good reason why you would want to change this 3100 is not in use on my server so I'm going to leave it but if you didn't want to leave it you could say oh you know what 3106 isn't in use you can change it to that it's fine completely up to you how you do this so I'm going to leave it at 3100 he's got some volumes here where he's just naming the volumes and he says home box data and Driver local everything there should be okay we're going to do control o to save and then Ctrl X to exit Nano we're just going to clear this out and we're going to run this home box install very quickly with Docker hyphen compose up Dash D and then two ampersands Docker hyphen compose logs Dash F so this is two commands connected by these Ampersand signs the first command is Docker compose up Dash D what this command says is run this thing go pull down the image and get it started and then run it in the background for me as a Daemon that's what the Dash D is for so right in the background so that even when I leave the terminal and kill my SSH session the application continues to run the second command says once you've done that show me the logs and let me see them live the dash F says just let me see those things live as they're coming in and when I'm done I'll hit Ctrl C to get out of the logs so I like to do that because I can see if I get any errors or issues things like that so we're going to hit go it's going to go out pull down this stuff it's very quick it doesn't have a lot to it and it's done so now it's going to start showing me the logs as it starts up there's not a lot for it to do really it's pretty much done it says start an HTTP server on 7745 now remember we want to use the host Port which is 3100 so we're going to go back to our Firefox window here we'll open up a new tab and first we're going to go by IP address so I'm going to go to the IP address of my host machine and I'm going to put in a colon 3100 is the port and we should get home box and you'll see we have homebox login screen and here's the register button so if I go and set that flag this register button goes away and I don't have a way to create a user so first I'm going to do register I'm going to fill out the information here so I'm going to use my email that I use for everything and my username or my name I'm going to put Brian that's fine and my password let's create a nice strong password for us to use here and he tells us it's pretty good all right cool so I'm going to say register now if you got here and you didn't mean to you can click this button to go back to the login page but if you meant to get here you want to click register first I'm going to tell it don't save it's fine right now so we're gonna go here it's already got our email filled in he just wants us to verify that we do actually know the password we typed in and I'm going to hit log in then again I'm just going to tell you it'll save for now so we're logged in all right so here's the top of the of the board here's everything of course not much here but pretty nice actually kind of a nice layout you got some side panel stuff here and he's building it out as he goes he's got a good roadmap set up he's got a lot of people that have already put in requests for enhancements so that's pretty awesome I'm sure you could use some help so if you're a go developer on the back end or if you're a developer for vue.js on the front end you may could provide some some help to him as well and enhance the project just to throw that out there too all right so I like this this is set up we're set but let's go back and let's disable registration because I don't want somebody to be able to get on my instance so I'm going to go and I'm going to log out right here sign out okay you see the registration button still there so let's bring up our terminal again and we can close out of our logs and let's just do Docker in fact we'll just go make the change let's do Nano docker compose.yaml we're going to go down here and we're going to add that that environment variable that he told us about so let's go back to this page here and find it and it's right here allow registration so we're just going to copy that and we're going to go back to our terminal and I'm going to make sure I don't hit that tab I want to hit Ctrl shift V this time to paste I'm going to put equals false Ctrl o to save just make sure I didn't make a mistake let me check some things and then we'll do Ctrl X to exit and now we're going to do Docker hyphen compose up Dash D again and that's basically going to bring it down and bring it back up so it's going to kind of very quick this is a very very simple program it's great I'm going to just go back over here go back to my tab I'm just going to refresh and if you look no more registration button so registration is disabled that's awesome we don't have to worry about anybody else getting in our system let's make sure we can still log in and we'll set our password right there just like we had earlier and we're logged in so our system knows who we are I can tell this never it's fine all right so we're done with the install like literally finished you are up and running if you don't want to watch any more of this video if you just want to go play around and tinker and see what you can figure out great otherwise stick with me because we're going to get into the user interface and the web UI first instead of using my IP I actually want to create a reverse proxy so that I can access this thing outside of my home network I can get to it with a normal domain name URL so I'm going to show you how to do that now I use a program called nginx proxy manager so when I open it up I log into it and it's only available on my local network I'm going to go in here and I'm going to create a new proxy and I will Zoom this up so you guys can see what I'm doing so first thing I want to do is give it a name now I own the domain routemehome.org I have a wild card entry set as asterisk.routmehome.org and that points to my home public IP address so when I make any request to dot routemehome.org so whatever.robmyhome.org it comes to my home IP address my firewall says oh I see a request on either Port 80 or Port 443 I'm going to forward that right over to your nginx proxy manager server nginx proxy manager gets that request and says okay let me see if I have one of those things listed here for your entries if if it's whatever.romyhome.org and it goes I don't see it it just gives you a congratulations page that's it you can't go anywhere else but if it sees it it says oh I see what you put there let me send you to the right place to get to your application so I'm going to call this homebox.rowmehome.org I'm going to hit tab so it turns into this little gray chip I'm just going to leave that on https I'm going to go to 192.168.10.42 you would want to put in the IP address of your host this is the IP address of my host where it's running and it's running on Port 3100. I'm going to put in Block common exploits allow websockets you can do cash assets and this is smart if you're using something like WordPress or something that's got more static content that you're going to be loading over and over and over but in this case it's content that's changing a lot of times because your assets are changing your inventory is getting updated so I'd say do it this way up to you I'm just going to hit save I'm going to go down here to homebox.robmehome.org I'm just going to click on it here in the interface and it'll open up a new tab and make sure that I can get to it which I did that's awesome I'm going to close that tab I'm going to come right back in here and on the right end I'm going to click on the three dots I'm going to click on edit and then right here I'm going to jump over to the SSL tab up here at the top I'm going to hit request a new SSL certificate right here under SSL I'm going to say Force SSL HTTP 2 support make sure my email is correct and then I'm going to hit I agree to the lesson script terms of service I'm going to hit save that's going to spin for a second but if this little modal if this pop-up box goes away without any errors we're set it's going to be let's encrypt encrypted from now on if I get an error I just need to see what happened and go and try to fix it so I'm going to click on this again you can see right here it says let's encrypt now I'm going to click on it and now we're attaching to this thing with an actual SSL certificate we've got our little lock icon so I can log back in and put in my password Here There we go and now I can tell it yeah you can save that if you want to but I don't it's fine all right so we've got this up and running we're accessing it we can access over the Internet we can access it however we want and we've got it with https encryption which is awesome so we're ready to get into the user interface and actually start using the software now I'll say if you've not used inventory software before and you've got a bunch of inventory you might already have a spreadsheet set up so he does have the ability to import data so that you don't have to worry about kind of putting it in all by hand so you've got this option to say import and you see right here it pops up he wants you to have a CSV file it's got to have a certain set of headers and things like that and columns they have to be in a certain order but you can get that stuff off of this documentation over here over here somewhere there we go so he talks right here about importing data so if you click it'll take you to the importing Data Page and right here he's got a list and you can see it Scrolls to the right so don't forget about that but all these columns you can go and actually create a spreadsheet and put the information you have if you don't have information for that item don't put it in that column just just leave that column blank for that row but fill out your rows get everything in there and then import it maybe you already have this you just need to rearrange your spreadsheet and then save it as a CSV and import it that's a fast fast way to get a bunch of data into a system like this it makes it really nice he's got a CSV reference right here he tells you what's the column name what's the type so what's it expecting for values and data and then it gives you a nice description I mean this is a really really well laid out set of instructions and tutorials on how to use this software so it's really great I like this a ton it is really awesome the way that he set this up so now we're in here we've got import we can do inventory actions you've got all kinds of Cool Tools here you can run reports which is pretty great so being able to do reports especially in a small business is very important if we go over here to home you can see kind of your starting dashboard and right here you've got different locations in the house so this could be your business this could be your home now it's called home box but again I think this could work for a small business you've got different labels down here so it kind of gives you a starting place and then you can go in and kind of modify what you want out of this briefly turned on the light color theme so be patient because we're going to go to profile we're going to go to user profile and here you can edit your profile but down here he's got all of his different themes which I really like these themes so if you pick a theme that you like you can click on it you can see how it changes if I pick the blue here you see what happens so you can kind of get a theme and a color set that you're that you're enjoying um he's got some different looks and different feels to him as well this one gives you kind of rounded buttons which is really nice so I'm going to go back to this very cool I like this color it's pretty great but there you go now up here you can do group settings and user profile so you can create groups and groups of people and and users so this does have a lot of really kind of cool capability now you can generate an invite link you can change the password all kinds of really cool Power here you can also delete an account so very very useful but also be careful about this he's got the button red for a reason so just realize that's a back button if you click it you could do something you didn't mean to as we continue we've got search so you can search for items that are in the system now I don't have anything in here yet but you can see what's going on there here's the locations that we saw a while ago and if you want to add new locations you could say create and then do location so I have oh I don't know I have so many different things in my house let's just talk about one of them so we have the um outside office there's an inside office and outside office so I'll put it this way and then I can say the back office area and if there's a parent location you can pick one so I could make office the parent location and then create an inside office as well so I can do that you can see here what I get so it kind of creates this new office and it says detail view so I can turn off detail view if I want to and then I can create another one so let's go create inside office as well inside office office in the house and in fact let's just call this because I have two I have Brian's office and we will go down here and make that office and then we'll go add one more because my wife has an office too so be office and office slash Warehouse is where she works basically in our house but yeah we'll go down and we'll add that under office so now we've got that so if we go click on our locations you can see that we've got this tree of locations that gets built out I really kind of like how that works that's pretty awesome and he's got this button up here to collapse all the trees so if you really start building this out into a lot of stuff you can collapse it all at once which is pretty great but there you go we can see different locations around the house and then if you click on them you come back to those detail areas and you can see what's going on so you can also create labels so let's just let's go look at the labels he's got so we go back to home he's got these labels here at the bottom he's got appliances Electronics General iot important and servers so that's a lot of the stuff that I need but it's not everything so I could also put something just very simple like Furniture if I spell it right and you can give it a description if you want to but Furniture is pretty clear for me and I can say create and now I've created Furniture I can go here and I can create another one so you can just kind of go crazy with the different things that you may want or may want to use but instead of just servers you could say laptops lighting it just depends on what you have and what you're trying to keep your inventory up to date with so very simple very basic but very cool so let's go add some actual items here so I did just do a screen refresh I grabbed my new labels let's see if we go to office it shows that we've got other places under the office which is good so let's go back and let's do a create again let's do create an item or asset let's see yeah now we've got the new places that's good there's my office we're going to put roll top desk and we're going to put that as Furniture oh it doesn't type to narrow it down just do it yeah right here furniture There we go so you can put more than one label and then we're just going to do we've got create and we've got create and add another so it's kind of up to you but I'm just going to do create and then now we've got a whole bunch of other details so that is not the only detail that you can put in for that so you've got the details then you've got this log so I can add an image to the log I guess um total entries total cost oh monthly average yeah so if you have something that's using up you know money and things like that you can track that as well and then you've got the ability to edit the details so kind of up to you how you do this but I think the edit thing is the next thing you want to do for most of these things this is why I say this could get really tedious doing one thing at a time having a spreadsheet if you've already got one like I do it would be really useful to reorder your columns make sure you've got the right stuff there and then upload that thing make a copy of the one you you're working with already and then do that don't mess with the one you've already got when you come into the edit one of the things to take note of is that you have this Advanced tick and it's not on this is off so make sure you turn that on so let me change the uh the view just a little bit here let me change this theme I'm not going to change it to a bright theme but maybe a theme that will have a better uh tick mark box let's see the blue looks nice we can probably use that how about this one what's this we'll go to the desk and if we go to edit so you notice this is turned off I just wanted to make that a little bit easier to see so I changed the theme for you when I turn that on I get a lot of other information here so now we've got the parent item so if this has a parent item we can actually show that you get all the detail you've already put in but then you've got serial number model number you've got manufacturer you've got notes and information then you've got insured archived okay so you can go and set that up asset ID is important make sure that's a unique field you've got custom Fields you can add so we'll come back to that but then you've got attachments so you can drag and drop files here maybe you've got images you've got images of the labels or the stickers or things on it that's really important you've got purchase details that you can fill in so how much did it cost you know who did you purchase it from how much did it cost when did you purchase it you've got warranty details is it under warranty so you can check the box for a lifetime warranty or you can put the date in for a warranty you can put warranty notes just for like who do you call those kind of things very very useful and you've got details if you sell it eventually if you sell it you want to put that in who do you sell it to on what date because that could come up if you've ever watched a cop show you know that they come looking for property and you want to be able to tell them no I sold it to Bob and Bob's the guy you need to look for right so as we go down as we come back we've got the custom Fields here so you can add a custom field and you're going to get a field name and then it's going to have a value that you're assigning to that so maybe you want this to be something like you know lint out and this could be I think it only takes strings right now but it could be yes no right so yes and then you can do add lint to Jason and add and lent on and we can put in a date so let's just put in February and I know other parts of the world do this different but I'm in the US so forgive me and then if we need to get Jason's phone number for some reason we can but we can say this is when we lent it out and Jason's gonna return it to us but we've got that record now right so Jason borrowed my roll top desk that's awesome once I've made any changes I want to keep I just hit save and it saves those things and now I've got my custom Fields as well this is really a nice system I think it's just absolutely a great starter system and again if it's just for your home very very straightforward easy to use you can do a lot with those very very simple and easy to use custom Fields you can add labels again stacking and tracking different locations is pretty awesome I like that it has tree capability that's really cool again for a small business maybe even up to a kind of a medium small medium-sized business this could be a really great tool I just think this was such a such a cool thing I really enjoyed using it and starting it so I want to share with you guys but there you go that's home box I hope you guys enjoyed this if you did like subscribe tell your friends about it so they can come along on the journey with us and I'll talk to you next time foreign [Music]

Channel: Awesome Open Source

Views: 97,186

Keywords: open, source, opensource, open-source, self, hosted, selfhosted, self-hosted, free, libre, software, server, web, internet, browser, linux, mac, macos, os x, windows, microsoft, unix, bsd, ios, android, pi, raspberry, desktop, vps, tutorial, how to, setup, installation, instructions, cli, command line, terminal, interface, network, networking, news, projects, snipe-it, homebox, inventory, management, spiceworks, samsara, asset panda, asset tiger, zoho, reftab, sysaid, inventree, binner, bin, binning, home, business, asset, assets

Id: XawMT0fg_To

Length: 28min 50sec (1730 seconds)

Published: Thu Feb 23 2023