Migrate Braiins Manager Agent to the Newest Generation
Overview
Braiins Manager Agent v4.0.0+ introduces a new Rust-based architecture with significantly improved performance, reduced resource usage, and better stability. Follow the steps below to migrate your existing Node.js-based Agent to the latest version.
Migrate Braiins Manager Agent
Update Braiins Manager Agent on Linux
Make sure you have access to the server where the Agent is installed.
- Open the terminal on your server.
- Copy and execute the migration script:
- Follow the interactive steps in the terminal. The script will:
- Stop the Node.js agent.
- Uninstall it safely.
- Install the Rust-based agent.
- Preserve your settings and configuration.
- Once migration is complete:
- Open the Agent UI to verify that it's running.
- In Braiins Manager, go to the Locations page, click "Confirm Update", and verify that the Agent version has changed to v4.0.0+.
Update Braiins Manager Agent on Windows
Make sure you have access to the server where the Agent is installed.
- Open PowerShell as Administrator on your server.
- Run the migration script:
- Follow the guided instructions in PowerShell. The script will:
- Stop the Node.js agent.
- Uninstall it safely.
- Install the Rust-based agent.
- Preserve your settings and configuration.
- Once migration is complete:
- Open the Agent UI to verify that it's running.
- In Braiins Manager, go to the Locations page, click "Confirm Update", and verify that the Agent version has changed to v4.0.0+.
Troubleshooting & Support
If you encounter any issues during the migration, please contact our support team directly.
Was this helpful?