diff --git a/archetypes/posts.md b/archetypes/posts.md index 5ee5ccc..cc93ef8 100644 --- a/archetypes/posts.md +++ b/archetypes/posts.md @@ -1,9 +1,9 @@ --- -title: { { replace .TranslationBaseName "-" " " | title } } +title: {{ replace .TranslationBaseName "-" " " | title }} description: "" -tags: [""] +tags: [] author: "ahmza" -date: { { .Date } } +date: {{ .Date }} draft: true weight: featureimage: diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml index 56beb0e..0a30604 100644 --- a/config/_default/hugo.toml +++ b/config/_default/hugo.toml @@ -14,6 +14,11 @@ pagination.pagerSize = 10 buildDrafts = false buildFuture = false +# Keep source-art and editor backup files out of the built site. Without this, +# files inside page bundles (e.g. feature.aseprite) are copied into public/ as +# page resources and served publicly. +ignoreFiles = ['\.aseprite$', '\.bak$'] + enableEmoji = true # googleAnalytics = "G-XXXXXXXXX" diff --git a/content/posts/arrstack/arrstack.md b/content/posts/arrstack/index.md similarity index 93% rename from content/posts/arrstack/arrstack.md rename to content/posts/arrstack/index.md index df9380a..d87333d 100644 --- a/content/posts/arrstack/arrstack.md +++ b/content/posts/arrstack/index.md @@ -1,7 +1,7 @@ --- title: Arrstack description: -tags: [""] +tags: [] author: "ahmza" date: 2025-05-09T23:44:27+01:00 draft: true diff --git a/content/posts/be-more-productive-by-being-bored/index.md b/content/posts/be-more-productive-by-being-bored/index.md index a85fd83..84f114d 100644 --- a/content/posts/be-more-productive-by-being-bored/index.md +++ b/content/posts/be-more-productive-by-being-bored/index.md @@ -4,7 +4,7 @@ description: In the modern age we are overwhelmed with stimuli. Learn to cut out tags: - lifestyle - minimalism - - prodcutivity + - productivity author: ahmza date: 2024-01-02 draft: false diff --git a/content/posts/mc-server-on-docker/index.md b/content/posts/mc-server-on-docker/index.md index 4c012ed..f7cd453 100644 --- a/content/posts/mc-server-on-docker/index.md +++ b/content/posts/mc-server-on-docker/index.md @@ -185,8 +185,8 @@ cd .server-data 2. **Download a Minecraft server jar file:** - [Vanilla Minecraft Server](https://www.minecraft.net/en-us/download/server) - - Right-click the green link that says minecraft_server..jar and copy the link address. - - Download with: curl -o server.jar + - Right-click the green link that says `minecraft_server..jar` and copy the link address. + - Download with: `curl -o server.jar ` - [Fabric Mod loader server](https://fabricmc.net/use/server/) - Select the Minecraft version, Fabric Loader Version, and the Installer Version of your choice. I tend to go with the latest. - Download with: Copy the curl command under CLI download diff --git a/content/posts/mc-server-on-docker/index.md.bak b/content/posts/mc-server-on-docker/index.md.bak deleted file mode 100644 index 8b1f325..0000000 --- a/content/posts/mc-server-on-docker/index.md.bak +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Minecraft Server on Docker ⛏ 🐳 -date: 2022-05-24 -lastmod: 2024-07-20 -author: "ahmza" -draft: false -weight: - -tags: ["games", "docker"] -description: "Ever wanted to build a Minecraft server in docker !! Start here" ---- - -## **Introduction** - -Minecraft is a great game that becomes even more enjoyable when played with -friends. One of the best ways to do this is by setting up a dedicated server. -This guide will help you do just that! - -Setting up and running a Minecraft server does not require a lot of resources, -but based on my experience, allocating more resources significantly enhances -performance. Especially when you start to add mods and increase player count. - -## **Prerequisites** - -- Docker -- Docker Compose - -See [Pi Cluster](/posts/pi-docker-swarm/) -for more information about my docker setup. - -## **Requirements** -_Requirements Gathered from [here](https://minecraft.fandom.com/wiki/Server/Requirements/Dedicated#Unix_.28Linux.2C_BSD.2C_macOS.29)_ - -### **Minimum (1-5 Players)** - -- Intel Pentium 4 or AMD Athlon based CPU -- 512 MB RAM -- 2 GB Storage space - -### **Recommended (10-15 Players)** - -- Intel Core or AMD K8 based CPU -- 3 GB RAM -- 16 GB Storage Space - -### **Optimal (20+ Players)** - -- Intel i5/i7 or AMD Ryzen 5/7 Based CPU -- 6 GB RAM -- 35 GB Storage Space - -**My opinion**: - -I personally went with the **optimal** settings as I wanted to run mods as well -as have the capacity for ~10 players. This gives the server breathing room. - -However if you will be runing no mods or a few light weight mods and only a few -players then there really is no need to go higher than 3-4 GB. - -## **Building the Container** - -Lets get started on building the Minecraft server - -1. **Create a directory for the Minecraft server files**: -```bash -# Make the folder -mkdir minecraft-server -# Enter the folder -cd minecraft-server -``` - -2. **Create an environment file for the Docker Container**: -- The _.env_ file allows us to specify variables used in the build process. -```bash -# Create a .env file -touch .env -# Open in a text editor -vim .env -# Enter the following variables -CONTAINER_NAME=minecraft-server -SERVER_MEM=4096 #change this to your desired value (in MB) -SERVER_JAR=.jar # Minecraft server jar file. Change this later -``` - -3. **Create the _docker-compose.yml_ file**: -```bash -# Create the file -touch docker-compose.yml` -# Open in a text editor -vim docker-compose.yml -``` -- _docker-compose.yml_ is the spec of our Minecraft server. - - Build a docker image using context . and pass some ARGS. - - Attach volume .server-data, where Minecraft's files will be stored. - - Open network ports to access to the Docker container - - Give the docker container a name - - The container will always restart unless we tell it to stop. - -```yaml -services: - minecraft-server: - build: - context: . - args: - SERVER_MEM: ${SERVER_MEM} - SERVER_JAR: ${SERVER_JAR} - volumes: - - .server-data:/server - ports: - - 25565:25565 # Game - - 25575:25575 # RCON - container_name: ${CONTAINER_NAME} - restart: unless-stopped - -volumes: - server-data: -``` - -4. **Create the _Dockerfile_ file**: - -- requested in docker-compose.yml build stage as context . -- The _Dockerfile_ is the spec for software running inside the container - -```bash -# Create the file -touch Dockerfile -# Open the file in a text editor -vim Dockerfile -``` -- We use the [eclipse-temurin:21](https://hub.docker.com/_/eclipse-temurin) image to provide the java JRE - - Use the required java version for the version of Minecraft you are running -- Collect the ARGs from the .env file -- Set the environment variables -- Set the working directory to /server which on our local system is .server-data -- Run the minecraft server jar with the ENV variables - -```Dockerfile -FROM eclipse-temurin:21 - -ARG SERVER_MEM -ARG SERVER_JAR - -ENV SERVER_MEM=${SERVER_MEM} -ENV SERVER_JAR=${SERVER_JAR} - -WORKDIR /server - -CMD echo "Minecraft Server is starting\n" && java -Xms128M -Xmx${SERVER_MEM}M -jar ${SERVER_JAR} nogui -``` - -## **Setup the Server files** - -We’re almost there, just a few steps to go. - -When you try to start the container, you might encounter the following error: -```bash -Minecraft Server is starting - -Error: Unable to access jarfile server.jar -``` -This happens because we haven't downloaded the server jar file yet. Let's do -that now - -1. **Create a folder in the minecraft-server folder called .server-data**: - -```bash -mkdir .server-data -cd .server-data -``` - -2. **Download a Minecraft server jar file**: - - [Vanilla Minecraft Server](https://www.minecraft.net/en-us/download/server) - - Right click the green link that says minecraft_server..jar and copy the link address - - Download with: `curl -o server.jar ` - - [Fabric Mod loader server](https://fabricmc.net/use/server/) - - Select the Minecraft version, Fabric Loader Version and the Installer Version of your choice. I tend to go with the latest. - - Download with: `Copy the curl command under CLI download` - -3. **Go back to the root minecraft-server folder** - -```bash -cd .. -``` - -4. **Edit SERVER_JAR in .env with the name of the .jar you just downloaded**: -```bash -# Open in a text editor -vim .env -# Enter the following variables -CONTAINER_NAME=minecraft-server -SERVER_MEM=4096 -SERVER_JAR=.jar # Change this to the name of the .jar you downloaded -``` - -5. **Run the container to generate necessary files like 'eula.txt'**: -```bash -docker compose up -``` -you will see something like this: -```bash -minecraft-server | Starting net.minecraft.server.Main -minecraft-server | [18:05:50] [ServerMain/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info. -minecraft-server exited with code 0 -``` - -6. **Accept the EULA**: - -```bash -# edit eula.txt in a text editor -vim .server-data/eula.txt -# change `eula=false` to `eula=true` -eula=true -``` - -7. **Make any additional changes you want**: -- Notable files: - - **server.properties** - Configure server name, game mode, world type etc… - - **ops.json** - server operators (can be set in-game) - - **whitelist.json** - players allowed to join the server (can be set in-game) - -## Run the Minecraft Server - -1. **Run the container in detached mode**: -```bash -# The -d flag allows the container to run in detached mode, i.e., in the background -docker compose up -d -``` - -```bash -# monitor the logs as the server starts. Use CTRL+C to exit -docker logs minecraft-server --follow -# If you see the following lines, your server is up and running: - [18:17:01] [Server thread/INFO]: Time elapsed: 25529 ms - [18:17:01] [Server thread/INFO]: Done (34.571s)! For help, type "help" -``` - -## **Conclusion** - -Congratulations! You've successfully set up a Minecraft server. Now it's time -to play! - -There are many exciting possibilities from here, such as installing mods or -creating scripts to manage the server. Enjoy your Minecraft adventures! diff --git a/content/posts/pi-docker-swarm/index.md b/content/posts/pi-docker-swarm/index.md index 2b21a45..53281da 100644 --- a/content/posts/pi-docker-swarm/index.md +++ b/content/posts/pi-docker-swarm/index.md @@ -39,8 +39,6 @@ a **bare metal server that sucks a lot of power to a low power solution.** - 4 x PoE hats - 1 x 5 port PoE Switch -![Cluster(fix this image)](/img/pi-docker-swarm/cluster.webp) - ### **Point Of This post** After following this post you will have setup _Docker swarm_ on a cluster of Pis @@ -329,7 +327,7 @@ vim hosts ``` - **_[piCluster]_** - specifies a group of hosts -- **__** - change these to the Pis IP addresses +- **_``_** - change these to the Pis IP addresses **create the Pi Intercommunication keys** diff --git a/content/posts/securing-ssh/index.md b/content/posts/securing-ssh/index.md index ec94497..d26c7b1 100644 --- a/content/posts/securing-ssh/index.md +++ b/content/posts/securing-ssh/index.md @@ -2,9 +2,9 @@ title: Securing SSH 🤖 description: Ever wanted to make your SSH connections more secure. Read this tags: - - HomeLab - - RemoteAccess - - SSH + - homelab + - remoteaccess + - ssh author: ahmza date: 2021-12-07 draft: false @@ -146,7 +146,7 @@ fine 😊 - Max Auth Tries 5 - PasswordAuthentication no - PermitEmptyPasswords no -- AllowUsers +- AllowUsers `` - ClientAliveInterval 180 ``` bash diff --git a/content/posts/setup-a-hugo-site/index.md b/content/posts/setup-a-hugo-site/index.md index 3d40560..42a69d8 100644 --- a/content/posts/setup-a-hugo-site/index.md +++ b/content/posts/setup-a-hugo-site/index.md @@ -3,7 +3,7 @@ title: Setup a HUGO Site description: Always wanted to setup a static website. Look no further !! In this post we go over the basics of setting up a HUGO site tags: - blog - - HUGO + - hugo - web - development author: ahmza diff --git a/content/posts/setup-wsl/index.md b/content/posts/setup-wsl/index.md index 3dc7291..a7d0f3c 100644 --- a/content/posts/setup-wsl/index.md +++ b/content/posts/setup-wsl/index.md @@ -36,7 +36,7 @@ wsl --install Go to the Microsoft store and search for a Linux distribution. I prefer to use the "Ubuntu" distribution. -![Microsoft Store](/img/WSL/ubuntu.webp) +![Ubuntu in the Microsoft Store](ubuntu.webp) Once installed, go ahead and run the distribution, after it finishes setting itself up it will ask you for a username and password. These credentials are @@ -51,7 +51,7 @@ I use the windows terminal app to run the Ubuntu distribution, it makes customising the environment a lot easier. To download it head over to the Microsoft store and search for Windows Terminal and download it. -![Microsoft Store](/img/WSL/winterm.webp) +![Windows Terminal in the Microsoft Store](winterm.webp) When you login to WSL it will not default to your home directory. To fix that go to the Windows Terminal Settings look for Ubuntu or your distributions name and @@ -61,11 +61,11 @@ change the Starting directory to \\wsl$\\home\ ``` -> Be sure to change "" to your distributions name +> Be sure to change `` to your distributions name -> Be sure to change "" to your username +> Be sure to change `` to your username -![winterm-settings](/img/WSL/winterm-settings.webp) +![Windows Terminal settings](winterm-settings.webp) ## **Conclusion** diff --git a/content/posts/welcome/index.md b/content/posts/welcome/index.md index 602836d..827af90 100644 --- a/content/posts/welcome/index.md +++ b/content/posts/welcome/index.md @@ -1,5 +1,6 @@ --- title: Welcome +description: The mandatory hello world post — a quick intro to who I am and what this blog is about. tags: - blog - misc diff --git a/layouts/_default/_markup/render-link.html b/layouts/_default/_markup/render-link.html index 6bfc90f..69a1c1a 100644 --- a/layouts/_default/_markup/render-link.html +++ b/layouts/_default/_markup/render-link.html @@ -1 +1 @@ -{{ .Text | safeHTML }} +{{ .Text | safeHTML }} diff --git a/layouts/partials/extend-footer.html b/layouts/partials/extend-footer.html index 56065d8..ce8c712 100644 --- a/layouts/partials/extend-footer.html +++ b/layouts/partials/extend-footer.html @@ -1,6 +1,6 @@
- Mastodon - Github - Linkedin + Mastodon + Github + Linkedin
diff --git a/layouts/shortcodes/image.html b/layouts/shortcodes/image.html index 907b299..f62398d 100644 --- a/layouts/shortcodes/image.html +++ b/layouts/shortcodes/image.html @@ -1 +1 @@ -{{ .Get +{{ .Get diff --git a/layouts/shortcodes/video.html b/layouts/shortcodes/video.html index cf063fe..ede1d43 100644 --- a/layouts/shortcodes/video.html +++ b/layouts/shortcodes/video.html @@ -1,4 +1,4 @@ -