From 85302310cede0546bde822cb51cf12b21560ca1a Mon Sep 17 00:00:00 2001 From: Jack Spiering <46534141+jackspiering@users.noreply.github.com> Date: Sat, 18 Apr 2026 18:19:21 +0200 Subject: [PATCH 1/5] Change Markdown Linting action to rumdl and update config Updated the Markdown Linting action to use a different GitHub action and modified its configuration. rumdl is faster and updates compared to the current linter. --- .github/workflows/linting.yml | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml index e5b57e24..2480d771 100644 --- a/.github/workflows/linting.yml +++ b/.github/workflows/linting.yml @@ -28,10 +28,11 @@ jobs: steps: - name: Clone this repo uses: actions/checkout@v6 - - - name: Markdown Linting Action - id: lint - uses: avto-dev/markdown-lint@v1.5.0 + + - name: Markdown Linting + uses: rvben/rumdl@v0.1.74 with: - config: "./.markdownlint.yml" - args: "./services/**/*.md" + path: "services/" + config: ".markdownlint.yml" + report-type: annotations + From c7b623d602abd9fe758ed440dd29651de49f3cd9 Mon Sep 17 00:00:00 2001 From: jackspiering <46534141+jackspiering@users.noreply.github.com> Date: Fri, 24 Apr 2026 14:15:57 +0200 Subject: [PATCH 2/5] Fixed linting errors --- .github/PULL_REQUEST_TEMPLATE.md | 2 ++ README.md | 6 +++--- documentation/tailscale-on-arm.md | 4 ++-- services/adguardhome/README.md | 2 +- services/glance/README.md | 2 +- services/paperless/README.md | 2 +- services/rustdesk-server/README.md | 2 +- 7 files changed, 11 insertions(+), 9 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 8658daf9..b49cd29f 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -6,6 +6,7 @@ ## Related Issues + - None. ## Verification @@ -20,4 +21,5 @@ ## Additional Context + - None. diff --git a/README.md b/README.md index 16087b80..182851b1 100644 --- a/README.md +++ b/README.md @@ -22,20 +22,20 @@ ScaleTail provides ready-to-run [Docker Compose](https://docs.docker.com/compose Go to the [Tailscale Admin Console → Keys](https://login.tailscale.com/admin/settings/keys) and generate a new auth key. 2. **Clone and Choose a Service** - + Clone the repository and change directory to your desired service with the following command: ``` bash git clone https://github.com/tailscale-dev/ScaleTail.git cd ScaleTail/services/YourDesiredService ``` - + 3. **Configure and Launch** - Open the `.env` file in your chosen service directory. - Add your auth key after the line `TS_AUTHKEY=`. - Start the Docker compose stack: - + ``` bash docker compose up -d ``` diff --git a/documentation/tailscale-on-arm.md b/documentation/tailscale-on-arm.md index e043ec48..464e4fb5 100644 --- a/documentation/tailscale-on-arm.md +++ b/documentation/tailscale-on-arm.md @@ -13,7 +13,7 @@ First, attempt to install Tailscale using the official script: curl -fsSL https://tailscale.com/install.sh | sh ``` -- If this works, skip ahead to [Step 4](#4-run-tailscale). +- If this works, skip ahead to [Step 4](#4-create-an-initd-service-for-tailscale). - If it fails (common on OpenPLi), continue with the manual installation below. --- @@ -135,7 +135,7 @@ tailscale up You will receive an authentication URL, for example: -``` +```text To authenticate, visit: https://login.tailscale.com/c/129a3b4e01e114a diff --git a/services/adguardhome/README.md b/services/adguardhome/README.md index a23f4de8..e7fa44fa 100644 --- a/services/adguardhome/README.md +++ b/services/adguardhome/README.md @@ -19,7 +19,7 @@ In Debian (e.g. Ubuntu Server 22.04.x / 24.04.x) systems, particularly when usin `DNSStubListener` is a configuration option in the `/etc/systemd/resolved.conf` file that controls whether the `systemd-resolved` service will listen for DNS queries on the loopback address (127.0.0.53) over port 53. - **DNSStubListener=yes**: When this option is enabled, `systemd-resolved` binds to `127.0.0.53:53`. This allows the system to use `systemd-resolved` as a local DNS resolver for local DNS queries. - + - **DNSStubListener=no**: Disabling the stub listener prevents `systemd-resolved` from binding to port 53 on the local interface, freeing up this port for other DNS services or applications that require direct control over port 53. ### Why Change `DNSStubListener` to `no`? diff --git a/services/glance/README.md b/services/glance/README.md index 8877f974..19596432 100644 --- a/services/glance/README.md +++ b/services/glance/README.md @@ -6,7 +6,7 @@ This Docker Compose configuration sets up [Glance](https://github.com/glanceapp/ [Glance](https://github.com/glanceapp/glance) is a sleek, real-time dashboard for monitoring your system metrics, Docker containers, and other self-hosted services. It offers a clean and responsive interface that consolidates key system stats and service statuses in one place. This configuration uses Tailscale to securely expose your Glance instance, keeping it protected from the public internet and accessible only within your private Tailscale network. -To install Glance properly, make sure to add the files glance.yml and home.yml to the config folder. The contents of these files can be found [here](https://github.com/glanceapp/docker-compose-template/tree/main/root/config). Also add the file user.css to the assets folder which can be found [here](https://github.com/glanceapp/docker-compose-template/tree/main/root/assets). +To install Glance properly, make sure to add the files glance.yml and home.yml to the config folder. The contents of these files can be found [at their Github repo](https://github.com/glanceapp/docker-compose-template/tree/main/root/config). Also add the file user.css to the assets folder which can be found [at their Github repo](https://github.com/glanceapp/docker-compose-template/tree/main/root/assets). ## Configuration Overview diff --git a/services/paperless/README.md b/services/paperless/README.md index afd80ebb..1cadb1cf 100644 --- a/services/paperless/README.md +++ b/services/paperless/README.md @@ -1,4 +1,4 @@ -# Paperless-ngx with Tailscale Sidecar Configuration +# Paperless-ngx with Tailscale Sidecar Configuration This Docker Compose configuration sets up [Paperless-ngx](https://docs.paperless-ngx.com/) with Tailscale as a sidecar container to securely deliver push notifications over a private Tailscale network. By integrating Tailscale in a sidecar configuration, you enhance the privacy and security of your ntfy instance, ensuring it is only accessible within your Tailscale network. diff --git a/services/rustdesk-server/README.md b/services/rustdesk-server/README.md index bd8ed484..f4af728a 100644 --- a/services/rustdesk-server/README.md +++ b/services/rustdesk-server/README.md @@ -12,7 +12,7 @@ In this setup, the `tailscale-rustdesk-server` service runs Tailscale, which man ## Client setup -- Service Configuration: The Rustdesk client public Key credentials are generated at first run and stored in the **id_ed25519.pub** file. This is found in the compose directory **./rustdesk-server-data/hbbs/** Clients can be setup using the --config switch. e.g. **rustdesk.exe --config "host=rustdesk.your-tailnet.ts,key=thetextfromkey"** or in the client Setting -> Network -> ID/Relay Server. There is no need to configure the relay or API server. +- Service Configuration: The Rustdesk client public Key credentials are generated at first run and stored in the **id_ed25519.pub** file. This is found in the compose directory **./rustdesk-server-data/hbbs/** Clients can be setup using the --config switch. e.g. **rustdesk.exe --config "host=rustdesk.your-tailnet.ts,key=thetextfromkey"** or in the client Setting -> Network -> ID/Relay Server. There is no need to configure the relay or API server. Links: From 3e2f1cee395de9ec4046dd7e8292c7b90b47365a Mon Sep 17 00:00:00 2001 From: Jack Spiering <46534141+jackspiering@users.noreply.github.com> Date: Fri, 24 Apr 2026 14:43:32 +0200 Subject: [PATCH 3/5] Update Markdown Linting action version --- .github/workflows/linting.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml index 2480d771..6281cea1 100644 --- a/.github/workflows/linting.yml +++ b/.github/workflows/linting.yml @@ -30,7 +30,7 @@ jobs: uses: actions/checkout@v6 - name: Markdown Linting - uses: rvben/rumdl@v0.1.74 + uses: rvben/rumdl@v0.1.80 with: path: "services/" config: ".markdownlint.yml" From 152792cc151f540c3241a5e5d297156d47feb0dc Mon Sep 17 00:00:00 2001 From: Jack Spiering <46534141+jackspiering@users.noreply.github.com> Date: Fri, 24 Apr 2026 14:47:05 +0200 Subject: [PATCH 4/5] Update linting workflow to include README linting --- .github/workflows/linting.yml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml index 6281cea1..d7d0fee9 100644 --- a/.github/workflows/linting.yml +++ b/.github/workflows/linting.yml @@ -29,10 +29,16 @@ jobs: - name: Clone this repo uses: actions/checkout@v6 - - name: Markdown Linting + - name: Lint services uses: rvben/rumdl@v0.1.80 with: path: "services/" config: ".markdownlint.yml" report-type: annotations - + + - name: Lint README + uses: rvben/rumdl@v0.1.80 + with: + path: "README.md" + config: ".markdownlint.yml" + report-type: annotations From 5a178cb7645cd5c3b31c764cf74436d4d3ce8bee Mon Sep 17 00:00:00 2001 From: Jack Spiering <46534141+jackspiering@users.noreply.github.com> Date: Fri, 24 Apr 2026 14:54:06 +0200 Subject: [PATCH 5/5] Simplify linting workflow by removing README step Removed redundant linting step for README.md in workflow. --- .github/workflows/linting.yml | 7 ------- 1 file changed, 7 deletions(-) diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml index d7d0fee9..ecaaa680 100644 --- a/.github/workflows/linting.yml +++ b/.github/workflows/linting.yml @@ -35,10 +35,3 @@ jobs: path: "services/" config: ".markdownlint.yml" report-type: annotations - - - name: Lint README - uses: rvben/rumdl@v0.1.80 - with: - path: "README.md" - config: ".markdownlint.yml" - report-type: annotations