MiruSuite Docs

Appearance

Remote Access ​

MiruSuite can be controlled remotely using the Web Interface or companion from another device in the same network or even over the Internet. You need to configure your firewall to allow incoming connections to the MiruSuite server. MiruSuite uses port 8443 for the Web Interface and port 8080 for the companion connection.

WARNING

You should only allow incoming connections from trusted sources. If you want to access MiruSuite from the Internet, you should use a VPN or other secure connection.

Windows: Configure Firewall ​

When you first start MiruSuite, Windows should prompt you to allow network access. If you missed this prompt or need to reconfigure the firewall:

  1. Search for and open Windows Defender Firewall with Advanced Security.
  2. Click on Inbound Rules in the left sidebar.
  3. Click New Rule... in the right sidebar.
  4. Select Program and click Next.
  5. Browse to the lib folder in the MiruSuite installation directory and select miruServer.exe, then click Next.
  6. Select Allow the connection and click Next.
  7. Important: Check the boxes for the network profiles where you want to allow access:
    • Private: Check this if you're on a trusted home or work network (recommended for most users)
    • Public: Only check this if you need access on public networks (use with caution)
    • Domain: Check this if you're on a corporate domain network
  8. Give the rule a descriptive name like "MiruSuite Web Interface" and click Finish.
  9. Repeat steps 3-8 to create rules for both ports if needed, or ensure both ports 8443 and 8080 are allowed.

To verify your existing firewall rules:

  1. Open Windows Defender Firewall with Advanced Security.
  2. Click on Inbound Rules and look for rules related to mirusuiteserver-runner.exe: Firewall Inbound Rules
  3. Double-click the rule to check its properties and ensure traffic is allowed: Firewall Properties

Private vs Public Network

Windows distinguishes between Private and Public networks:

  • Private networks are trusted networks like your home or workplace
  • Public networks are untrusted networks like coffee shops or airports

For security, MiruSuite should typically only be accessible on Private networks. You can change your network profile in Windows Settings > Network & Internet > Properties.

macOS: Configure Firewall ​

If you have the macOS firewall enabled, you need to allow incoming connections for MiruSuite:

  1. Open System Settings (or System Preferences on older macOS versions).
  2. Navigate to Network > Firewall (or Security & Privacy > Firewall on older versions).
  3. If the firewall is off, you can skip this section. If it's on, click Firewall Options... (or Options...).
  4. Make sure that Block all incoming connections is disabled. macOS: Block all incoming rule
  5. Click the + button to add an application.
  6. Navigate to the MiruSuite application in your Applications folder and select it.
  7. Ensure the setting next to MiruSuite is set to Allow incoming connections.
  8. Click OK to save your changes.

Alternatively, you can use the built-in firewall command in Terminal:

bash
/usr/libexec/ApplicationFirewall/socketfilterfw --add /Applications/MiruSuite.app
/usr/libexec/ApplicationFirewall/socketfilterfw --unblockapp /Applications/MiruSuite.app

You may have to execute these commands with admin privileges by prepending them with sudo .

Testing Network Access

After configuring your firewall, test the connection from another device:

  1. Find your computer's local IP address via the launcher application or your OS (Windows: ipconfig, macOS: System Settings > Network or ifconfig on older versions)
  2. On another device on the same network, open a web browser
  3. Navigate to https://[YOUR-IP-ADDRESS]:8443 (e.g., https://192.168.1.100:8443)
  4. Accept the security certificate warning (same as when accessing localhost)