This content originally appeared on DEV Community and was authored by Zaid Sunasra
The Journey of Integrating Node.js as a Sidecar in Tauri
In this article, I share my experience tackling a challenge many Tauri developers might encounter—connecting a Node.js server as a sidecar in a Tauri app. Initially, the process seemed straightforward, but I ran into multiple roadblocks. The lack of comprehensive resources or clear solutions online made it an even steeper climb.
After trying various approaches, I turned to the Tauri GitHub discussions for help. It was there that a maintainer, Fabian Lars, stepped in and provided guidance that clarified the situation and helped resolve the issue. This article aims to highlight the problem I faced, share insights from the discussion, and document the lessons I learned along the way.
Create Tauri App
Note: Make sure you have the prerequisites for using Tauri installed.
Check pre-requisites
npm create tauri-app@latest
Or visit docs
Create a Nodejs package
The following commands will convert your node.js file into an executable(.exe). Replace file_name with the name of your node.js file.
npm install -g pkg
Packaging file_name.js into an .exe
pkg file_name.js --targets node20-win-x64
The above will crate an .exe file for windows.
For Linux: node18-linux-x64
For MacOS: node18-macos-x64
To create 3 .exe at a time use following command:
pkg index.js --targets node18-win-x64,node18-linux-x64,node18-macos-x64
This will create an file_name.exe file.
Note- But we need to rename the file as it is required for Tauri to identify it as a sidecar. Name format required for .exe file is: any_name-${targetTriple}${extension}
You can find your current platform’s -$TARGET_TRIPLE suffix by looking at the host: property by running the following code in terminal:
rustc -Vv
Copy the host property from above command and rename file_name.js
to file_name.js-host_property_value.exe
Example: file_name-x86_64-pc-windows-msvc.exe
Configuring our main file
1. Go to src-tauri. Create a folder name binaries. In the folder place the above .exe created.
2. Go to src-tauri/tauri.conf.json
{
"bundle": {
"externalBin": [
"binaries/file_name"
]
}
}
Note: Just add the file name.
3. Run the following commands:
npm run tauri add shell
npm install @tauri-apps/plugin-shell
4. Copy the following code to src-tauri/capabilities/default.json
Note: You will see warning in this file saying folder not present. Ignore the warnings as the folder will be generated once you follow all the steps.
"permissions": [
"core:default",
"opener:default",
"shell:default",
{
"identifier": "shell:allow-spawn",
"allow": [
{
"name": "binaries/file_name",
"sidecar": true
}
]
},
"shell:allow-open"
]
5. Add the following code in src/main.tsx or src/main.jsx
import { Command } from '@tauri-apps/plugin-shell';
const command = Command.sidecar('binaries/file_name', ["args", "if", "any"]);
await command.spawn();
6. Run the following command
npm run tauri dev
You have successfully integrated your server into the Tauri app. To verify the setup, open the app, and it should prompt for permission to run Node.js. Alternatively, you can check the server's status by visiting localhost and the port it is running on in your browser.
This content originally appeared on DEV Community and was authored by Zaid Sunasra
Zaid Sunasra | Sciencx (2025-01-11T19:35:48+00:00) Adding Node.js server to Tauri App as a sidecar. Retrieved from https://www.scien.cx/2025/01/11/adding-node-js-server-to-tauri-app-as-a-sidecar/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.