I've been using bookstack in docker for all my homelab docs stuff, but I do like your doc site so I'll fumble through this and see how I go, but I have very little knowledge on coding. It's on my list of things to learn. Should be fun :D
Agreed. I was literally looking over the mess that's my Google Spreadsheet document the day before this came out, trying to figure out how the hell I was going to make it work.
I followed these steps but for some reason my github actions keeps failing to deploy it on GITHUB even though its working okay on my local machine. Anyone else having this issue ?
Just got through this, you need the assets/lib submodule on the chirpy repo. After that, you need to set "use submodules : true" (commented out by default) on the repo's deploy.yml file. Hope this helps!
Great tutorial.... I'll be implementing this. Could you have a tutorial on Kubernetes deployments - I still struggle with how to deploy and then expose services especially incorporating those services with nginx and cloud flare on my domain
Hey I followed the exact steps, when I push my changes, github actions run fine as well. But I don't see gh-pages branch in settings→pages. Am I missing anything here?
This video was fantastic, thank you for replying to the comment I left on one of your other videos asking about this documentation site. It was a little rocky for me to get things going at first as I'm a networking guy not a web/dev guy but I think I've got a handle on how everything is working now thanks to this tutorial. Now its off to figure out the custom self hosted docker container video you mentioned at the end of this video.
Thank you! I have a video in creating a custom docker image! Build YOUR OWN Dockerfile, Image, and Container - Docker Tutorial ru-vid.com/video/%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE-SnSH8Ht3MIc.html
Great video! For whatever reason, in the Settings -> Pages I'm not getting the gh-pages branch. The only options for me to select are main and none... Not sure what step I'm missing. I've deleted the repo and started over twice already to see if there's something that I've missed and ended up with the same issue. Any ideas? I'm using Windows 11.
I'm getting the following. Perhaps a dependency is not installing? I'm using Windows. continuous-delivery Error: The process '/opt/hostedtoolcache/Ruby/2.7.6/x64/bin/bundle' failed with exit code 16 at ExecState._setResult (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:6023:25) at ExecState.CheckComplete (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:6006:18) at ChildProcess. (/home/runner/work/_actions/ruby/setup-ruby/v1/dist/index.js:5900:27) at ChildProcess.emit (node:events:390:28) at maybeClose (node:internal/child_process:1064:16) at Process.ChildProcess._handle.onexit (node:internal/child_process:301:5)
UPDATE: After digging into it, the issue was within the setup of continuous delivery. Specifically the Ruby setup. I was receiving a message stating "Your bundle only supports platforms ["x64-mingw-ucrt"] but your local platform is x86_64-linux." with instructions on how to add the current platform to the lockfile. All clear after I ran that command. In case anyone runs into a similar problem.
@@bachhoang9004 Do you have all of the dependencies installed? Confirm with ruby -v gem -v gcc -v g++ -v make -v If you're receiving the same message that I was: "your bundle only supports platforms...." under Actions -> [your commit that failed] -> continuous-delivery -> Setup Ruby -> bundle install, which is right before where the error occurred for me, then you should see the following: "Your bundle only supports platforms ["x64-mingw-ucrt"] but your local platform is x86_64-linux. Add the current platform to the lockfile with `bundle lock --add-platform x86_64-linux` and try again." After running that command, it worked for me. I hope this helps.
When I commit and pushed through github desktop, the post was visible on my site but nothing appeared in category or tags. It did however when I pushed and commit through the terminal in VS code. Just thought I'd mention this since there was nothing about it in your docs. Cheers for the guide, Tim.
17:20 now getting upload error: continuous-delivery Error: The process '/opt/hostedtoolcache/Ruby/2.7.6/x64/bin/bundle' failed with exit code 16 PS this happens because he uses linux, if you are on windows you'll be stuck. in order to solve this, run locally: bundle lock --add-platform x86_64-linux I wasted 2 hours to find the workaround hence not so straightforward
Anyone on apple silicon: gem uninstall ffi bundle config build.ffi --enable-libffi-alloc bundle install This fixed my error: gems/gems/ffi-1.15.5/lib/ffi/library.rb:275: [BUG] Bus Error at 0x0000000102d38000
@TechnoTim I am sending the .md file as a post, but it doesn't appear on my website. How can I fix this situation? Also, video is very useful, thank you!
This is amazing, I literally use this for creating a locally hosted site that does have a small login screen before you can get into it with a password that I only know. It holds so many of my notes for programming and also assist me with IT Related solutions. I've been working on it for about 4 months now and its all thanks to this video.
Would be kind to see a guide on how to run/deploy this site on a local environment like a LXC without the github pages part. In this case we can run it behind a reverse proxy or even just localy for local documentations. Anyways, good guide as always :)
Seeing the section about a CDN got me to thinking. I personally have my own CDN using a combination of Backblaze and Cloudflare. It's pretty much free.* I could not imagine a standard home lab racking up a massive cost with how cheap Backblaze bucket storage is. So Tim, do you use a CDN and if so, it would be cool to see a video on this topic. If you have any questions about how The Backblaze and Cloudflare combo work I would be more than happy to offer some pointers!
I really would like to know if there is an extension in VS Code that you are using that pulled up the list of timezones as you were typing yours out in the config.yml file. It even auto correct your spelling mistake by the end. If so, what is that extension? Would love to be able to use that!
@@TechnoTim I can see this being a content piece... "so in a previous video, i showed you how to use Jekyll and a lot of people asked why not Hugo. Well, I use Hugo as well, and in this video, I will show you how to use Hugo to . It's very similar to ".... ;)
Pass the --livereload option to serve to automatically refresh the page with each change you make to the source files: bundle exec jekyll serve --livereload
Man I finally got this working... But what a pain in the @##!! the yaml header and the markdown for each post are really finicky, it took me for ever to get a first post working.
You remind me of Johnny Depp a lot. Thank you for helping me start out with Jekyll! I already was hosting on github pages but somehow i didn't try jekyll and was coding html and css, but all my pages had extension .html 😅
Am getting Conversation Error Jekyll::: Converters ::Scss encounterer an error while converting assets/css/jekyll-theme-chirpy.scss how should I go about it pl, i need help
This is awesome. but I have a problem on last section. I can not find 'gh-pages' in Pages of Setting menu. so after few minutes my page shows "--- layout: home # Index page --- "
@@TechnoTim I entered the same command (the name of the folder of the git repository) even in the same enviroment (looks like youre running WSL in Windows Terminal) but I get "command not found " error instead of your fancy "git(main): " input
After two hours of fighting with bundler and gem on MacOS I am discouraged of using anything Ruby related ever again. :( I just want a very basic website but making Jekyll work seems to be harder than learning html.
Hello Tim. Thanks for the video. I am running Jekyll on a container and the problem I am facing is not being able to perform live-reload. I always need to stop and restart the container to view the changes. I am using volumes too. I have tried everything but none seems to work.
Somehow my posts aren't appearing when I'm creating a post. Have created my post exactly as yours was in the video but when I got to Chirpy in the web browser or even the generated "_site' folder there's no post appearing. Have tried restarting the jeklyll instance, i.e, re-runing 'bundle exec jekyll serve'. I'm not sure what's gone wrong. Any pointers?
I am confused right from the start, you started typing sudo apt get requests into what terminal? I rewatched this video many times but I do not see where you mentioned this at all? Where are you installing to?
On Ubuntu 22 (jammy) LTS ARM64 (running in Parallels on M1), I had to install ruby-bundler. For whatever reason ruby-full did not install it. Just a heads up. I think it was skipped over in the video, but does show the gem way to do that in the documentation.
@@emeraldbonsai The issue was actually a missing step in the video that is in the documentation. Also, when I push to github, the action fails for me. So now I have to go do a bit of debugging....
Definitely is not working. The github action keeps failing after push. Local site is fine, but the automatic build keeps failing. If you are not building and browsing locally, this lets you browse from a remote machine: bundle exec jekyll s -H `hostname -I | awk '{print $1}'`
This one got me and took me a while to figure out. When you create your post don't name it just `homelab-docs.md` it should be in a specific format. It should be `year-mouth-day-post_name.md` format.
Mine were not showing up either. Then I rewatched this and found that he made a change around the 14:18 mark and never mentioned a single thing about it. Notice that he names the post file 'hello-homelab.md', but when showing the git commit stuff it has the date in front of it. I went back to my file and renamed it to have the date in front of it and all of the sudden it appeared. Maybe this is something that recently changed with this starter, but I doubt it as it is happening in this video but no mention was made. Hope this helps you.
Can you write a wiki or post a video for how to host it on Cloudflare pages please and a video for Hexo and other similar Static site generators Please
This is amazing. I’ve always wanted to get into blogging but I’ve always felt the barrier to learning Wordpress or some other cms tool/platform was too high. As a developer, this is the perfect solution. Thanks for the awesome video!
Followed the exact steps on creating the markdown post in the _post folder but when I refresh the page, the site is empty. Anyone experiencing the same problem
NOICE! I wonder how to break this out so like if I had a repo for a project all of this would like in a folder 'docs' and the project code lives in maybe 'source' or 'code' and when you push domain.tld points to the project and docs.domain.tld points to the docs. (all from the same repo). I am struggling with project specific docs.
Hi :) Thx for the video, this is what I was looking for. Unfortunately I ran into an issue. After created my first page and reloaded the server, my page doesn't render. I tried to create a second page and same issue. I'm still looking how to resolve that :)
Thanks for the video! I also hosted jekyll with chirpy, but since 3 days my layout looks broken. I checked your site and it seems broken as well. Is it just my browser or is something else going on?
@@TechnoTim Thanks a lot! I didn't do anything and it worked again. But tbh I don't really understand the reason behind it. My pihole has no blocked querries from the jekyll host
Great video! Can Jekyll publish Word documents? I try to keep my lab documentation on word but it will be great to have an open source and self hosted solution that can publish word documents into a web page in a blog or portal with some indexing structure. If Jekyll doesn't have this capability do you know any other potential solution? Thanks!