Error installing Miro SFU

[jdaviescoates]

@nebulon said in Error installing Miro SFU:

on the host system

That still isn't very clear, but I think you mean SSH into the server, and run it there, right?

I don't even have this problem at present, just asking for the greater good

[nebulon]

Yes sorry for the confusion, so I mean SSH into the Ubuntu server itself (in contrast to a webterminal into the app container).

[jdaviescoates]

I just spotted that my MiroTalk has errored out with this again:

Docker Error: (HTTP code 500) server error - driver failed programming external connectivity on endpoint 16628ecd-d520-4174-ab00-d1eee973101a (8041bbc62efcf050c988cabb0c91fb4d516ac1b3076532b1d284c4f34fadf506): failed to bind port 0.0.0.0:40020/tcp: listen tcp4 0.0.0.0:40020: bind: address already in use

Hitting the retry button in repair didn't work the first time, but it did work the second time

[nebulon]

Yes this is a known issue we have seen rarely. Somehow docker hasn't freed up the port yet. A retry fixes the issue, but we haven't been able to reproduce this reliably for debugging and fixing.

[Meuschke]

@nebulon for me the retry won't fix that issue. Do you want to take a look? I have got Version v9.0.0 and after automatic backup the app start failed yesterday. Today I restarted the whole Server, but the app start keeps failing.

[jdaviescoates]

@Meuschke what if you just install a completely new instance of the app? Does it work then?

[Meuschke]

@jdaviescoates I haven't tried yet. But I think this will work. But I thought it was a good way to test and debug, because retry don't fix the error.

[joseph]

I think this issue was boiled down to the usage of ephermeral ports . That port which you are trying to install mirotalk in is in use by some other process . See https://forum.cloudron.io/topic/14259/sftpgo-or-mirotalk-sfu-not-starting-because-they-use-ephemeral-ports/ . In essence, use ports < 32767 . The coming version already shows a warning when you try this range.

[Meuschke]

@joseph I didn't know that. Thank you. I will reinstall.

[MiroTalk]

@joseph said in Error installing Miro SFU:

I think this issue was boiled down to the usage of ephermeral ports . That port which you are trying to install mirotalk in is in use by some other process . See https://forum.cloudron.io/topic/14259/sftpgo-or-mirotalk-sfu-not-starting-because-they-use-ephemeral-ports/ . In essence, use ports < 32767 . The coming version already shows a warning when you try this range.

In case MiroTalk SFU support also WebRTCServer mode:

How to Enable WebRTCServer Mode in MiroTalk SFU (Use Fewer Ports)

If you want to reduce the number of ports used by MiroTalk SFU and make it easier to scale, you can enable the WebRTCServer Mode. This mode lets the internal WebRTC server handle all the media traffic, meaning you don’t need big port ranges anymore.

---

️ Step-by-Step Setup

1. Open your environment file
   In your file manager (or terminal), open the env file for your MiroTalk SFU instance.

2. Add the following line

   SFU_SERVER=true
   

3. Understand the new port behavior

   • If you start from port 25000, here’s what happens:

     • 1 CPU → 1 worker → uses port 25000
     • 2 CPUs → 2 workers → use ports 25000–25001
     • and so on…

   Each worker uses only one port, not a whole range.
   The WebRTCServer manages all internal media traffic automatically.
   MiroTalk SFU keeps working just like before only the port handling changes.

4. Restart your instance
   After saving the env file, restart your MiroTalk SFU instance.

---

Benefits

• Fewer open ports → simpler firewall setup
• Less chance of port conflicts
• Better scalability → easy to scale by CPU count
• Cleaner and more secure port configuration

---

🧠 Notes

This mode is still being tested, but early results look promising.
You can learn more about the WebRTCServer concept here:
Mediasoup Discussion: WebRTCServer and Port Binding