Get remote help with Remote Assist
Some problems are easier to fix with someone looking at your system. Remote Assist lets the support team connect to your host for a short session. You start it and stop it from the Deployrr Help menu. For a short look at the feature, watch Deployrr 6 overview: Remote Assistance with Tmate at 8:52.
Before you start
Section titled “Before you start”- A Pro license. Remote Assist only appears in the Help menu for Pro.
- An open help request on Discord. Ask there first. See Get help on Discord.
- A Discord direct message window open with the support team member who is helping you.
You do not need to forward a port on your router or change your firewall for Remote Assist. Your host does need outgoing internet access.
Turn on Remote Assist
Section titled “Turn on Remote Assist”-
Open Deployrr and select Help from the main menu.
-
Find Remote Assist. Its description reads “Toggle remote SSH support session -” followed by NOT ACTIVE in green.
-
Select Remote Assist.
-
Read the Remote Assist - Warning box. It says Deployrr installs tmate, a terminal sharing tool, if it is missing. Select Yes to continue. Select No to cancel.
-
In the Session Password box, keep the password Deployrr suggests, or type your own. Select OK.
-
Wait while Deployrr works through its steps on screen.
-
When the Remote Assist Enabled box appears, read it and select OK.
-
Open the file
Remote_SSH_Support_Details.txtin your Docker folder. The box shows the exact path.
Share the details
Section titled “Share the details”- Copy the SSH connection line and the session password from the file.
- Send them in a Discord direct message to the support team member who is helping you.
- Wait for them to connect. They need the session password to get in.
Turn off Remote Assist when done
Section titled “Turn off Remote Assist when done”- In Deployrr, select Help, then Remote Assist. The status now shows ACTIVE in red.
- Read the Remote Assist - Confirm Stop box. Select Yes.
- Wait for Deployrr to finish. It stops the session and deletes the details file.
- When the Change Password box appears, select Yes to set your original password back. This is the recommended choice.
- Type your new password, then type it again to confirm.
If you select No, Deployrr reminds you to run passwd yourself later. Do that soon, because the temporary password stays active until you change it.
You can also stop Remote Assist from Tools > Diagnostics. While a session is on, the Remote Assist row there reads “Status - ACTIVE - Security Warning!” and the overall health shows “Unhealthy - Issues detected”. Diagnostics can only stop a session. To start one, use Help > Remote Assist. See Deployrr shows “Unhealthy - Issues detected” for the other Diagnostics checks.
If your host restarts while Remote Assist is on, open Help and check the status. If it still shows ACTIVE, select Remote Assist to stop it. That cleans up the details file and lets you restore your password.
Check it worked
Section titled “Check it worked”- After you turn it on, the Help menu shows Remote Assist with ACTIVE in red.
- After you turn it off, the Help menu shows NOT ACTIVE in green.
- The file
Remote_SSH_Support_Details.txtis gone from your Docker folder. - If you changed your password back, you see a Password Changed box.
If something goes wrong
Section titled “If something goes wrong”- Remote Assist - Pro License Required. The box says “Remote Assist is only available for Pro license holders.” Ask on Discord. Support will tell you if remote access is needed and what to do instead.
- Remote Assist Already Active. A session is already running. Select Remote Assist again to stop it.
- Failed to create tmate session. Deployrr could not start the session. It adds “tmate may not be able to connect to its servers”. Check that your host has internet access, then try again. Deployrr has already set the temporary password at this point and does not change it back. Run
passwdto set your own password again. If it still fails, tell support on Discord. - Password Mismatch. The two passwords you typed were different. The temporary password is still active. Run
passwdto set your password. - Password Change Failed. Deployrr could not change the password. Run
passwdto set it yourself.
If you do not have a Pro license
Section titled “If you do not have a Pro license”Remote Assist is not in your Help menu. Discord is the way to get help for every license. Post your question there, and support will tell you how to go on. See Get help on Discord.

