From 543dc5a1a46bbb9c04531117c3279fbafb351a5e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Markus=20K=C3=BCffner?=
 <11882946+mkuf@users.noreply.github.com>
Date: Sat, 15 Nov 2025 16:26:02 +0100
Subject: [PATCH] add octoeverywhere service (#237)

---
 README.md           | 22 ++++++++++++++++++++++
 docker-compose.yaml | 14 ++++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/README.md b/README.md
index f9b89e3..ab7942f 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,8 @@ With a single command, you can start up Klipper and its accompanying application
 |<img src="https://avatars.githubusercontent.com/u/46323662?s=200&v=4" width=30px>|[moonraker-obico](https://github.com/TheSpaghettiDetective/moonraker-obico)|`upstream`|[Additional Profiles](#moonraker-obico)|
 |<img src="https://raw.githubusercontent.com/Donkie/Spoolman/master/client/icons/spoolman.svg" width=30px>|[Spoolman](https://github.com/Donkie/Spoolman)|`upstream`|[Additional Profiles](#spoolman)|
 |<img src="https://avatars.githubusercontent.com/u/41749659?s=200&v=4" width=30px>|[µStreamer](https://github.com/pikvm/ustreamer)|prind @ [docker/ustreamer](docker/ustreamer)|[Add your Configuration](#add-your-configuration-to-docker-composeoverrideyaml)<br>[Multiple Webcams](https://github.com/mkuf/prind?tab=readme-ov-file#multiple-webcams)|
+|<img src="https://octoeverywhere.com/img/logo/logo_maskable.svg" width=30px>|[OctoEverywhere](https://octoeverywhere.com)|`upstream`|[Additional Profiles](#octoeverywhere)|
+
 </details>
 
 ## Getting started
@@ -207,6 +209,26 @@ docker compose --profile fluidd --profile spoolman up -d
 
 Navigate to `http://<yourprinter>/spoolman` to access the spool manager webinterface.
 
+#### octoeverywhere
+[OctoEverywhere](https://octoeverywhere.com) can be enabled via the `octoeverywhere` Profile.
+
+Add your Printers IP address to `docker-compose.override.yaml` like so, then start the stack.
+```yaml
+services:
+  octoeverywhere:
+    environment:
+      PRINTER_IP: 10.0.0.11
+```
+```
+docker compose --profile mainsail --profile octoeverywhere up -d
+```
+
+After the stack has started, get the logs of the octoeverywhere service to retrieve the code to link your printer.
+
+```
+docker compose logs octoeverywhere
+```
+
 ## Updating
 Images are built daily and tagged with `latest` and the [git description](https://git-scm.com/docs/git-describe#_examples) of the remote repo. 
 Example: 
diff --git a/docker-compose.yaml b/docker-compose.yaml
index b89dc10..b844ef4 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -191,6 +191,19 @@ services:
       traefik.http.routers.octoprint.rule: PathPrefix(`/spoolman`)
       traefik.http.routers.octoprint.entrypoints: web
 
+  octoeverywhere:
+    image: octoeverywhere/octoeverywhere:latest
+    restart: unless-stopped
+    volumes:
+      - octoeverywhere-data:/data
+    profiles:
+      - octoeverywhere
+    environment:
+      COMPANION_MODE: klipper
+      MOONRAKER_PORT: 80
+    labels:
+      org.prind.service: octoeverywhere
+
   ## Accompanying Services/Infra
   ##
 
@@ -233,3 +246,4 @@ volumes:
       type: tmpfs
       device: tmpfs
   spoolman-db:
+  octoeverywhere-data: