First commit

This commit is contained in:
2026-03-26 23:01:22 +01:00
commit 9ba47371eb
5 changed files with 169 additions and 0 deletions

1
.gitignore vendored Normal file
View File

@@ -0,0 +1 @@
public

5
content/_index.md Normal file
View File

@@ -0,0 +1,5 @@
+++
title = "Blog"
sort_by = "date"
paginate_by = 10
+++

View File

@@ -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.

1
themes/terminimal Submodule

Submodule themes/terminimal added at 7f630a4e31

37
zola.toml Normal file
View File

@@ -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/"