#    Matterbridge Task Scheduler configuration (Windows) [](https://www.npmjs.com/package/matterbridge) [](https://www.npmjs.com/package/matterbridge) [](https://hub.docker.com/r/luligu/matterbridge) [](https://hub.docker.com/r/luligu/matterbridge)   [](https://codecov.io/gh/Luligu/matterbridge) [](https://vitest.dev) [](https://oxc.rs/docs/guide/usage/formatter.html) [](https://oxc.rs/docs/guide/usage/linter.html) [](https://www.typescriptlang.org/) [](https://github.com/microsoft/typescript-go) [](https://nodejs.org/) [](https://bun.com) [](https://matterbridge.io) [](https://www.npmjs.com/package/matter-history) [](https://www.npmjs.com/package/node-ansi-logger) [](https://www.npmjs.com/package/node-persist-manager) --- # Production configuration ## Run matterbridge as a scheduled task with Task Scheduler (Windows) This is the simplest setup on Windows. It runs Matterbridge when the current user logs in and uses the standard directories: - `%USERPROFILE%\Matterbridge` - `%USERPROFILE%\.matterbridge` - `%USERPROFILE%\.mattercert` ### Optional: cleanup all previous setups ```powershell schtasks /delete /tn "Matterbridge" /f Remove-Item -Recurse -Force "$HOME\Matterbridge", "$HOME\.matterbridge", "$HOME\.mattercert" -ErrorAction SilentlyContinue npm uninstall -g matterbridge ``` ### Verify node setup > **Nvm is a development tool and is not supported for production**. ```powershell node -v npm -v ``` It should output something like: ```text v22.20.0 10.9.3 ``` ### Check node path ```powershell where.exe node ``` It should output something like: ```text C:\Program Files\nodejs\node.exe ``` ### First create the Matterbridge directories and install matterbridge This will create the required directories if they don't exist and install matterbridge globally for the current user. ```powershell New-Item -ItemType Directory -Force -Path "$HOME\Matterbridge", "$HOME\.matterbridge", "$HOME\.mattercert" | Out-Null npm install -g matterbridge --omit=dev where.exe matterbridge.cmd matterbridge --version ``` ### Then create a scheduled task for Matterbridge Run PowerShell as Administrator ```powershell $NodeExe = (where.exe node | Select-Object -First 1) $MatterbridgeCmd = (where.exe matterbridge.cmd | Select-Object -First 1) $MatterbridgeJs = Join-Path (Split-Path $MatterbridgeCmd -Parent) "node_modules\matterbridge\bin\matterbridge.js" schtasks /create /f /tn "Matterbridge" /sc onlogon /delay 0000:30 /tr "`"$NodeExe`" `"$MatterbridgeJs`" --nosudo" ``` This will start Matterbridge 30 seconds after the current user logs in. This setup starts Matterbridge once at logon. If Matterbridge exits, it stays stopped until the next logon or until you start it again manually. You can configure and adapt the task on the Task Scheduler. ### Start Matterbridge ```cmd schtasks /run /tn "Matterbridge" ``` ### Stop Matterbridge Stop Matterbridge from the frontend. To force stop use ```cmd schtasks /end /tn "Matterbridge" ``` ### Restart Matterbridge Stop Matterbridge from the frontend. ```cmd schtasks /end /tn "Matterbridge" schtasks /run /tn "Matterbridge" ``` ### Show Matterbridge status ```cmd schtasks /query /tn "Matterbridge" /v /fo list ``` ### Show Matterbridge status (only essentials) ```cmd schtasks /query /tn "Matterbridge" /v /fo list | findstr /I "TaskName Status Last Run Time Last Result" ``` ### Enable Matterbridge to start automatically on logon ```cmd schtasks /change /tn "Matterbridge" /enable ``` ### Disable Matterbridge from starting automatically on logon ```cmd schtasks /change /tn "Matterbridge" /disable ``` ### Optional: remove the scheduled task completely Run PowerShell as Administrator ```cmd schtasks /delete /tn "Matterbridge" /f ```