Add support for remote mode

.vscode/settings.json

@@ -8,7 +8,7 @@
     "editor.detectIndentation": false,
     "[typescript]": {
         "editor.codeActionsOnSave": {
-            "source.organizeImports": true
+            "source.organizeImports": "explicit"
         }
     },
     "[javascript]": {
@@ -22,5 +22,6 @@
     "[markdown]": {
         "editor.tabSize": 4,
         "editor.insertSpaces": true
-    }
+    },
+    "cSpell.words": ["alcalzone", "iobroker", "Pids"]
 }

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-2025 UncleSamSwiss
+Copyright (c) 2021-2026 UncleSamSwiss
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -216,6 +216,8 @@ The following options are available:
 
 `--admin <version>` Define which version of admin to be used (default: "latest").
 
+`--remote` Set up dev-server on a remote host using SSH. You will be prompted for connection details.
+
 `--backupFile <filename>` Provide an ioBroker backup file to restore in this dev-server. Use this option to populate the dev-server with data (and possibly other adapters).
 
 `--symlinks` Use symlinks instead of packing and installing the current adapter for a smoother dev experience. Requires JS-Controller 5+.
@@ -325,16 +327,29 @@ When the adapter is ready, you will see a message like the following:
 ╰──────────────────────────────────────────────────╯
 ```
 
-You can now attach the Visual Studio Code debugger to the given process ID:
+You can now attach the Visual Studio Code debugger.
 
-- Open the Command Palette (Ctrl-Shift-P)
-- Choose "Debug: Attach to Node Process (legacy)"
-- Select the right process, it usually looks like follows:
+Create (or extend) a file called `.vscode/launch.json`:
 
+```json
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "attach",
+            "name": "Attach to remote",
+            "address": "127.0.0.1",
+            "port": 9229,
+            "outFiles": []
+        }
+    ]
+}
 ```
-node  --inspect <path to your dev-server directory>/node_modules/...
-process id: 1234, debug port: 9229
-```
+
+Note: It is important to set `"outFiles"` at least to an empty array, otherwise breakpoints will not work.
+
+Go to `Run and debug` (Ctrl-Shift-D), select `Attach to remote` and click on the green "play" button.
 
 Now you can set breakpoints (or they are hit if you set them before) and inspect your adapter while running.