From 0d3470a987757c413a7520e7b99e598ecbbaaa45 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 18 Apr 2026 20:33:35 +0000 Subject: [PATCH 1/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 51 +++++++++++++++++++++++++++++---------------------- 1 file changed, 29 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 5ecd61e..416c75a 100644 --- a/README.md +++ b/README.md @@ -252,8 +252,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod - - + + - - - + + + - - + + - - + + + + + - - - - + +
crypt0rr @@ -282,13 +282,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod michaelhodges - - LaijieJi -
- LaijieJi - - 		adamsthws @@ -296,8 +289,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod adamsthws
theryukverse @@ -305,6 +296,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod theryukverse
KhaaL @@ -320,10 +313,17 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod - - jpmurray + + onlykshitij
- jpmurray + onlykshitij + + 		+ + LaijieJi +
+ LaijieJi 		@@ -340,8 +340,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod mikkotor
NI-R0 @@ -384,8 +384,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod pjv
wedge22 @@ -393,6 +393,13 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod wedge22 + + jpmurray +
+ jpmurray + + 		Jacob-JA-Shanks @@ -421,6 +428,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod dfilvtov
cdkooistra @@ -428,8 +437,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod cdkooistra
Aurorainic @@ -458,8 +465,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod orchard0
From 14844f6b6467b09059f5460a9fe0e4f6331650c4 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 19 Apr 2026 05:37:32 +0000 Subject: [PATCH 2/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 416c75a..a2c4ae5 100644 --- a/README.md +++ b/README.md @@ -312,13 +312,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod SamPlaysKeys - - - onlykshitij -
- onlykshitij - - LaijieJi @@ -340,8 +333,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod mikkotor - - NI-R0 @@ -349,6 +340,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod NI-R0 + + RychidM @@ -384,14 +377,21 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod pjv - - wedge22
wedge22 + + + + + + onlykshitij +
+ onlykshitij + From 963ef66819efa74f0b90e3c38bf415988a56ad67 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Mon, 20 Apr 2026 05:49:27 +0000 Subject: [PATCH 3/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index a2c4ae5..416c75a 100644 --- a/README.md +++ b/README.md @@ -312,6 +312,13 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod SamPlaysKeys + + + onlykshitij +
+ onlykshitij + + LaijieJi @@ -333,6 +340,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod mikkotor + + NI-R0 @@ -340,8 +349,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod NI-R0 - - RychidM @@ -377,21 +384,14 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod pjv + + wedge22
wedge22 - - - - - - onlykshitij -
- onlykshitij - From b29e62489c77f5a116e616a456296a72de3c92d6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 1 May 2026 14:45:59 +0000 Subject: [PATCH 4/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 497c4dd..455a826 100644 --- a/README.md +++ b/README.md @@ -270,17 +270,17 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod - - ChillBill77 + + michaelhodges
- ChillBill77 + michaelhodges - - michaelhodges + + ChillBill77
- michaelhodges + ChillBill77 From ecd10b946f2fdffce39ee3e7a2ca529d35296e36 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 05:44:55 +0000 Subject: [PATCH 5/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 455a826..fb9e301 100644 --- a/README.md +++ b/README.md @@ -313,13 +313,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod SamPlaysKeys - - - onlykshitij -
- onlykshitij - - LaijieJi @@ -341,8 +334,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod mikkotor - - NI-R0 @@ -350,6 +341,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod NI-R0 + + RychidM @@ -385,14 +378,21 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod pjv - - wedge22
wedge22 + + + + + + onlykshitij +
+ onlykshitij + From 1e33d82102a898596c137bb84b4ff68fbb67d74e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sun, 3 May 2026 06:12:24 +0000 Subject: [PATCH 6/8] docs(contributor): contrib-readme-action has updated readme --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index fb9e301..455a826 100644 --- a/README.md +++ b/README.md @@ -313,6 +313,13 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod SamPlaysKeys + + + onlykshitij +
+ onlykshitij + + LaijieJi @@ -334,6 +341,8 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod mikkotor + + NI-R0 @@ -341,8 +350,6 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod NI-R0 - - RychidM @@ -378,21 +385,14 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod pjv + + wedge22
wedge22 - - - - - - onlykshitij -
- onlykshitij - From 15a9eca15afe9145c8edb1e62b8c9fa02b618381 Mon Sep 17 00:00:00 2001 From: michaelhodges Date: Thu, 7 May 2026 18:33:23 +0100 Subject: [PATCH 7/8] New Service - Filebrowser --- README.md | 1 + services/filebrowser/.env | 20 +++++++++ services/filebrowser/README.md | 21 ++++++++++ services/filebrowser/compose.yml | 72 ++++++++++++++++++++++++++++++++ 4 files changed, 114 insertions(+) create mode 100644 services/filebrowser/.env create mode 100644 services/filebrowser/README.md create mode 100644 services/filebrowser/compose.yml diff --git a/README.md b/README.md index f8dde30..3e34c8e 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,7 @@ ScaleTail provides ready-to-run [Docker Compose](https://docs.docker.com/compose | ✅ **DumbDo** | A self-hosted, minimalistic task manager for simple to-do lists. | [Details](services/dumbdo) | | ✅ **Eigenfocus** | A self-hosted task and project management tool for productivity. | [Details](services/eigenfocus) | | 📝 **Excalidraw** | A virtual collaborative whiteboard tool. | [Details](services/excalidraw) | +| 🗂️ **Filebrowser** | A file managing interface within a specified directory, it can be used to upload, delete, preview and edit your files. | [Details](services/filebrowser)| | 📝 **Flatnotes** | A simple, self-hosted note-taking app using Markdown files. | [Details](services/flatnotes) | | 👨🏼‍💻 **Forgejo** | A community-driven, self-hosted Git service. | [Details](services/forgejo) | | 👨🏼‍💻 **Gitea** | A lightweight, self-hosted Git service with repository hosting, pull requests, and issue tracking. | [Details](services/gitea) | diff --git a/services/filebrowser/.env b/services/filebrowser/.env new file mode 100644 index 0000000..fd58305 --- /dev/null +++ b/services/filebrowser/.env @@ -0,0 +1,20 @@ +#version=1.1 +#URL=https://github.com/tailscale-dev/ScaleTail +#COMPOSE_PROJECT_NAME= # Optional: only use when running multiple deployments on the same infrastructure. + +# Service Configuration +SERVICE=filebrowser # Service name (e.g., adguard). Used as hostnme in Tailscale and for ctainer naming (app-${SERVICE}). +IMAGE_URL=filebrowser/filebrowser:s6 # Docker image URL from container registry (e.g., adguard/adguard-home). + +# Network Configuration +SERVICEPORT=80 # Port to expose to local network. Uncomment the "ports:" section in compose.yaml to enable. +DNS_SERVER=9.9.9.9 # Preferred DNS server for Tailscale. Uncomment the "dns:" section in compose.yaml to enable. + +# Tailscale Configuration +TS_AUTHKEY= # Auth key from https://tailscale.com/admin/authkeys. See: https://tailscale.com/kb/1085/auth-keys#generate-an-auth-key for instructions. + +# Time Zone setting for containers +TZ=Europe/Amsterdam # See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones + +# Optional Service variables +# PUID=1000 diff --git a/services/filebrowser/README.md b/services/filebrowser/README.md new file mode 100644 index 0000000..4fc7f0a --- /dev/null +++ b/services/filebrowser/README.md @@ -0,0 +1,21 @@ +# Filebrowser with Tailscale Sidecar Configuration + +This Docker Compose configuration sets up [Filebrowser](https://filebrowser.org/index.html) with Tailscale as a sidecar container to keep the app reachable over your Tailnet. + +## Filebrowser + +[Filebrowser](https://filebrowser.org/index.html) File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview and edit your files. It is a create-your-own-cloud-kind of software where you can just install it on your server, direct it to a path and access your files through a nice web interface. + +## Configuration Overview + +In this setup, the `tailscale-Filebrowser` service runs Tailscale, which manages secure networking for Filebrowser. The `Filebrowser` service utilizes the Tailscale network stack via Docker's `network_mode: service:` configuration. This keeps the app Tailnet-only unless you intentionally expose ports. + +## What to document for users + +- The automatically generated password for the user admin is only displayed once when the container first runs. If you fail to remember it, you will need to manually delete the database and start File Browser again. + +## Files to check + +Please check the following contents for validity as some variables need to be defined upfront. + +- `.env` // Main variable `TS_AUTHKEY` diff --git a/services/filebrowser/compose.yml b/services/filebrowser/compose.yml new file mode 100644 index 0000000..809b05f --- /dev/null +++ b/services/filebrowser/compose.yml @@ -0,0 +1,72 @@ +configs: + ts-serve: + content: | + {"TCP":{"443":{"HTTPS":true}}, + "Web":{"$${TS_CERT_DOMAIN}:443": + {"Handlers":{"/": + {"Proxy":"http://127.0.0.1:80"}}}}, + "AllowFunnel":{"$${TS_CERT_DOMAIN}:443":false}} + +services: +# Make sure you have updated/checked the .env file with the correct variables. +# All the ${ xx } need to be defined there. + # Tailscale Sidecar Configuration + tailscale: + image: tailscale/tailscale:latest # Image to be used + container_name: tailscale-${SERVICE} # Name for local container management + hostname: ${SERVICE} # Name used within your Tailscale environment + environment: + - TS_AUTHKEY=${TS_AUTHKEY} + - TS_STATE_DIR=/var/lib/tailscale + - TS_SERVE_CONFIG=/config/serve.json # Tailscale Serve configuration to expose the web interface on your local Tailnet - remove this line if not required + - TS_USERSPACE=false + - TS_ENABLE_HEALTH_CHECK=true # Enable healthcheck endpoint: "/healthz" + - TS_LOCAL_ADDR_PORT=127.0.0.1:41234 # The : for the healthz endpoint + #- TS_ACCEPT_DNS=true # Uncomment when using MagicDNS + - TS_AUTH_ONCE=true + configs: + - source: ts-serve + target: /config/serve.json + volumes: + - ./config:/config # Config folder used to store Tailscale files - you may need to change the path + - ./ts/state:/var/lib/tailscale # Tailscale requirement - you may need to change the path + devices: + - /dev/net/tun:/dev/net/tun # Network configuration for Tailscale to work + cap_add: + - net_admin # Tailscale requirement +# ports: + #- 0.0.0.0:${SERVICEPORT}:${SERVICEPORT} # Binding port ${SERVICE}PORT to the local network - may be removed if only exposure to your Tailnet is required +# - 0.0.0.0:8080:80 # Binding port ${SERVICE}PORT to the local network - may be removed if only exposure to your Tailnet is required + # If any DNS issues arise, use your preferred DNS provider by uncommenting the config below + #dns: + # - ${DNS_SERVER} + healthcheck: + test: ["CMD", "wget", "--spider", "-q", "http://127.0.0.1:41234/healthz"] # Check Tailscale has a Tailnet IP and is operational + interval: 1m # How often to perform the check + timeout: 10s # Time to wait for the check to succeed + retries: 3 # Number of retries before marking as unhealthy + start_period: 10s # Time to wait before starting health checks + restart: always + + application: + image: ${IMAGE_URL} + network_mode: service:tailscale + container_name: app-${SERVICE} + depends_on: + tailscale: + condition: service_healthy + healthcheck: + test: ["CMD", "pgrep", "-f", "${SERVICE}"] # Check if ${SERVICE} process is running + interval: 1m # How often to perform the check + timeout: 10s # Time to wait for the check to succeed + retries: 3 # Number of retries before marking as unhealthy + start_period: 30s # Time to wait before starting health checks + restart: always + volumes: + - ./${SERVICE}-data:/srv + - ./${SERVICE}-database:/database + - ./${SERVICE}-config:/config + environment: + - PUID=1000 + - PGID=1000 + - TZ=${TZ} From b7b6c3816a5c007afd08272d515e99897b0e7a36 Mon Sep 17 00:00:00 2001 From: michaelhodges Date: Sun, 24 May 2026 20:45:41 +0100 Subject: [PATCH 8/8] Update compose.yml --- services/filebrowser/compose.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/services/filebrowser/compose.yml b/services/filebrowser/compose.yml index 809b05f..cb794bf 100644 --- a/services/filebrowser/compose.yml +++ b/services/filebrowser/compose.yml @@ -35,8 +35,7 @@ services: cap_add: - net_admin # Tailscale requirement # ports: - #- 0.0.0.0:${SERVICEPORT}:${SERVICEPORT} # Binding port ${SERVICE}PORT to the local network - may be removed if only exposure to your Tailnet is required -# - 0.0.0.0:8080:80 # Binding port ${SERVICE}PORT to the local network - may be removed if only exposure to your Tailnet is required + #- 0.0.0.0:${SERVICEPORT}:${SERVICEPORT} # Binding port ${SERVICE}PORT to the local network - may be removed if only exposure to your # If any DNS issues arise, use your preferred DNS provider by uncommenting the config below #dns: # - ${DNS_SERVER}