From 9ba47371ebc2b94a630f4b6d0ba4c8eec3a0ef93 Mon Sep 17 00:00:00 2001 From: Jika Date: Thu, 26 Mar 2026 23:01:22 +0100 Subject: [PATCH] First commit --- .gitignore | 1 + content/_index.md | 5 ++ content/mcscmanager_freebsd.md | 125 +++++++++++++++++++++++++++++++++ themes/terminimal | 1 + zola.toml | 37 ++++++++++ 5 files changed, 169 insertions(+) create mode 100644 .gitignore create mode 100644 content/_index.md create mode 100644 content/mcscmanager_freebsd.md create mode 160000 themes/terminimal create mode 100644 zola.toml diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a48cf0d --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +public diff --git a/content/_index.md b/content/_index.md new file mode 100644 index 0000000..d6f7558 --- /dev/null +++ b/content/_index.md @@ -0,0 +1,5 @@ ++++ +title = "Blog" +sort_by = "date" +paginate_by = 10 ++++ diff --git a/content/mcscmanager_freebsd.md b/content/mcscmanager_freebsd.md new file mode 100644 index 0000000..d6a97ba --- /dev/null +++ b/content/mcscmanager_freebsd.md @@ -0,0 +1,125 @@ ++++ +title = "Install MCSManager on FreeBSD" +description = "This blog will go trhough how to install and steup properly mcsmanger on FreeBSD" +date = 2026-03-25 +[taxonomies] +tags = ["FreeBSD", "Minecraft", "Admin"] ++++ + +Base documentation is pretty good and mostly work for FreeBSD but some specific details are left out. + +We will go through the each step of the isntallation and setup process but before that I still recomend checkig the [official documentation](https://docs.mcsmanager.com/). + +Some steps may be out of date and its still a good source of information. + + +## Dependencies + +The main dependency you will need for mcsmanager is node.js, you can install it with npm as a normal FreeBSD package. + +```sh +pkg install node npm +``` + +It could also be usefull to install at least one version of Java to be used by your Minecraft instancies even if there is now a Java version manager integrated. + +For example java17: + +```sh +pkg install openjdk17 +``` + + +## Installing MCSManager + +First go to wher you want it installed. Here I choosed ´/usr/local/mcsmanager´. Then you can download the latest release directly from github or any other version for tha matter, untar it and luach the install script. + +```sh +cd /usr/local/mcsmanger + +# download +fetch https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz + +# extract +tar --strip-components=1 -xzvf mcsmanager_linux_release.tar.gz +rm mcsmanager_linux_release.tar.gz + +# install (its downloading node pacakges) +bash install.sh +``` + +Those steps might not be necessary for you since when you are reading this those might be installed automatically but in my case they were not. So check that those libs are present in `deamon/lib` and if not you can just follow the steps to install them at teh right places. +```sh + +cd /usr/local/mcsmanger/daemon/lib/ + +# download libs +fetch https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_freebsd_x64 +fetch https://github.com/MCSManager/PTY/releases/download/latest/pty_freebsd_x64 + +# set permissions +chmod +x file_zip_freebsd_x64 pty_freebsd_x64 +``` + +If you want to be able to use the webui zip/unzip functionality you will also need 7-zip and a small wrapper so it can be found and used correctly. + +```sh +# 7zip +pkg install 7-zip + +# 7z wrapper +cd /usr/local/mcsmanager/deamon/lib +printf '#!/bin/sh\nexec /usr/local/bin/7zz "$@"\n' > 7z_freebsd_x64 +chmod +x 7z_freebsd_x64 +``` + + +## Dedicated user + +It is highly recomended to run the whole stack and instancies as an unprivileged user. So just create one and change the permissions of the relevant directory. + +```sh +cd /usr/local/mcsmanger + +# ownership +chown -R mcserver:mcserver . + +``` + +## Test run + +You can now start each process to detect any error. + +```sh +bash start-daemon.sh +bash start-web.sh +``` + + +## RC files + +As you could have guessed from previous specific FreeBSD libs, the project has explicit compatibility with it even though the documentation does not sepcific a FreeBSD intstall seciton. + +However it has a section about rc scripts that you should go check out [here](https://docs.mcsmanager.com/advanced/freebsd_rc.html) + +Then just create the files in `/usr/local/etc/rc.d/` and follow the usual steps. + +```sh +# service permissions +chmod +x /usr/local/etc/rc.d/mcsm* + +# enable +service mcsmd enable +service mcsmw enable + +# start services +service mcsmd start +service mcsmw start +``` + +## Final result + +You now have a fully working MCSManager stack. You can go to the webui and create your first instancies. + +To update just stop mcsmanager, run the intallation steps again this will override the necessary files and update the node dependencies. + diff --git a/themes/terminimal b/themes/terminimal new file mode 160000 index 0000000..7f630a4 --- /dev/null +++ b/themes/terminimal @@ -0,0 +1 @@ +Subproject commit 7f630a4e319c089f27b6704e622b38d874406381 diff --git a/zola.toml b/zola.toml new file mode 100644 index 0000000..76d8e10 --- /dev/null +++ b/zola.toml @@ -0,0 +1,37 @@ +# The URL the site will be built for +base_url = "https://blog.jika.li" + +# Whether to automatically compile all Sass files in the sass directory +compile_sass = true + +# Whether to build a search index to be used later on by a JavaScript library +build_search_index = true + +title = "My Blog" +theme = "terminimal" +generate_feeds = true + +taxonomies = [ + { name = "tags", feed = true }, +] + + +[markdown.highlighting] +theme = "catppuccin-mocha" + +[extra] +accent_color = "pink" +background_color = "dark" + +[extra.hero] +title = "Welcome to my blog" +subtitle = "Thoughts on code and craft" + +[[extra.nav]] +name = "Blog" +url = "/blog/" + +[[extra.nav]] +name = "About" +url = "/about/" +