From d161429a9fd7bf78abba7281d8be9674408b5bc7 Mon Sep 17 00:00:00 2001 From: ObsidianOracle Date: Fri, 7 Aug 2026 10:35:59 +0200 Subject: [PATCH 1/2] Changed the mistakes in the docs and added a special section for WSL --- doc/installation_guidelines/custom-themes.md | 34 ++++++++++++++++++-- 1 file changed, 31 insertions(+), 3 deletions(-) diff --git a/doc/installation_guidelines/custom-themes.md b/doc/installation_guidelines/custom-themes.md index 8590ecda8..c4fed74d9 100644 --- a/doc/installation_guidelines/custom-themes.md +++ b/doc/installation_guidelines/custom-themes.md @@ -18,16 +18,44 @@ No custom theme is loaded by default. The built-in `light` and `dark` themes `HASHTOPOLIS_CUSTOM_THEMES_DIR` is the on/off switch: it names the folder the container scans for `.css` files on startup. When it is unset, no custom themes are loaded and the app uses the built-in `light`/`dark` themes only. -To enable themes with Docker Compose, set the variable to the container path the entrypoint should scan and mount your `.css` folder to that same path by uncommenting both lines in `docker-compose.yml` (or `.devcontainer/docker-compose.yml`): +To enable themes with Docker Compose, set the variable to the container path the entrypoint should scan and mount your `.css` folder to that same path by adding both lines in the fronted section of your `docker-compose.yml` (or `.devcontainer/docker-compose.yml`): ```yaml environment: - - HASHTOPOLIS_CUSTOM_THEMES_DIR=/custom-themes + HASHTOPOLIS_CUSTOM_THEMES_DIR: /custom-themes volumes: - ./custom-themes:/custom-themes:ro ``` +Frontend section of the docker compose section now looks like this: -### Baking themes into the image (no runtime mount) +```yaml + hashtopolis-frontend: + container_name: hashtopolis-frontend + image: hashtopolis/frontend:latest + volumes: + - ./custom-themes:/custom-themes:ro + environment: + HASHTOPOLIS_BACKEND_URL: $HASHTOPOLIS_BACKEND_URL + HASHTOPOLIS_CUSTOM_THEMES_DIR: /custom-themes + restart: always + depends_on: + - hashtopolis-backend + ports: + - "4200:80" +``` +> [!NOTE] +> If you use WSL you need to adjust the both lines to: +> ``` + environment: + HASHTOPOLIS_CUSTOM_THEMES_DIR: ./custom-themes +> ``` +> and + ``` + volumes: + - ./custom-themes:/custom-themes:ro +>``` + +### Baking themes into the image (no runtime mount) - Only needed if you build the docker images yourself When building your own production image, pass the `CUSTOM_THEMES_DIR` build arg to copy a folder of `.css` files into the image (the default bakes nothing): From c101a9a349f7a94b3dbd52eb04a52d620752ff33 Mon Sep 17 00:00:00 2001 From: ObsidianOracle Date: Fri, 7 Aug 2026 10:44:08 +0200 Subject: [PATCH 2/2] changed layout of basic installation --- doc/installation_guidelines/basic_install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/installation_guidelines/basic_install.md b/doc/installation_guidelines/basic_install.md index 77b30cb85..9c4ab8555 100644 --- a/doc/installation_guidelines/basic_install.md +++ b/doc/installation_guidelines/basic_install.md @@ -44,10 +44,10 @@ wget https://raw.githubusercontent.com/hashtopolis/server/master/env.mysql.examp **or** Download docker-compose.postgres.yml and env.postgres.example for PostgreSQL - ``` +``` wget https://raw.githubusercontent.com/hashtopolis/server/master/docker-compose.postgres.yml -O docker-compose.yml wget https://raw.githubusercontent.com/hashtopolis/server/master/env.postgres.example -O .env - ``` +``` 3. Edit the .env file and change the settings to your likings