RemoteBox Logo

Open Source VirtualBox Client with Remote Management

Documentation

Manual

RemoteBox 1.8.1 : PDF Manual

FAQs

When troubleshooting problems with RemoteBox, launching it from the command line may provide additional debugginf information. Consulting the web service logs and the guest logs may also be useful. If you believe you've found a bug, please raise a ticket here

  1. I see SOAP versioning errors such as:
     Wrong SOAP version specified. Supported versions:
      1.1 (http://schemas.xmlsoap.org/soap/envelope/)
      1.2 (http://www.w3.org/2003/05/soap-envelope)
    You're probably affected by a bug introduced in RemoteBox v1.8. Upgrading to RemoteBox v1.8.1 or newer should resolve the issue.
  2. I get an error message on the command line similar to the following:
      “Incorrect parameter at <path>/SOAP/Lite.pm” line xxxx”. This is a bug in the implemention of Perl SOAP Lite you have installed. If possible you should upgrade to a fixed version. You can also work around this by editing the SOAP/Lite.pm file and changing the following line (usually around line 1993) from:
    die “Incorrect parameter” unless $itself =~/^d$/;
    
    replace with
    die “Incorrect parameter” unless $itself =~/^d*$/;
    
    (Note the addition of the asterisk *)
  3. I'm unable to login, even though I know my credentials are correct. Sometimes it does work, but mostly it does not. If your client is running Perl v5.18 or newer, you can either upgrade to RemoteBox v1.8.1+ or if your distribution supports it, downgrade to a version of Perl lower than v5.18. You can check your perl version using 'perl -v'. If you're credentials continue not to work, you should verify your server and its operating system configuration as logins may be getting denied elsewhere.
  4. I'm using rdesktop as my RDP client but it gives the following error:
     Autoselected keyboard map en-us
     Failed to negotiate protocol, retrying with plain RDP.
     WARNING: Remote desktop changed from 800x600 to 1280x1024.
     X Error of failed request: BadWindow (invalid Window parameter)
      Major opcode of failed request: 18 (X_ChangeProperty)
      Resource id in failed request: 0x0
      Serial number of failed request: 38
      Current serial number in output stream: 43
    Rdesktop versions 1.8.0 and 1.8.1 have severe problems when used with VirtualBox. You should upgrade your version of Rdesktop to v1.8.2+ or downgrade to a version lower than v1.8.0. Alternatively you may use the FreeRDP client which is now the default and recommended RDP client for use with RemoteBox.
  5. I'm using Rdesktop as my RDP client and cannot use the mouse or keyboard, even though I know I have the guest configured properly.
    Rdesktop versions 1.8.0 and 1.8.1 have severe problems when used with VirtualBox. You should upgrade your version of Rdesktop to v1.8.2+ or downgrade to a version lower than v1.8.0. Alternatively you may use the FreeRDP client which is now the default and recommended RDP client for use with RemoteBox.
  6. I get an error message saying 'Failed to Launch Remote Desktop Extension Server' You do not have the Oracle Extension Pack installed or you have an old version of the pack installed. Please download and install the appropriate Oracle Extension Pack for your version of VirtualBox.
  7. Why are the mouse pointers are out of sync when using the Remote Display? To enable mouse synchronisation, ideally Guest Additions should be installed and running within the guest opreating system. If this is not possible, then changing the mouse type to “USB Tablet” and ensuring USB support is enabled will work, providing the guest operating system supports USB and recognises USB Tablets correctly.
  8. I repeatedly get disconnected from the server, what's wrong? Assuming you don't have a terrible network, you probably have a low timeout configured for the web service, or you have disabled the heartbeat in RemoteBox. Please ensure the heartbeat is enabled in RemoteBox (File->Preferences->Heartbeat) and ensure that the web service has timeouts disabled or is not configured for a timeout lower than 60 seconds. The RemoteBox manual describes how to set the timeout.
  9. I'm unable to take a screenshot of the guest, or set a screenshot as an icon. Increasing the amount of Video RAM assigned to the guest to at least 2MB seems to resolve the issue. Otherwise it could be that your build of VirtualBox was created without PNG support.
  10. Sometimes the interface is slow, why? RemoteBox is completely dependent on the responsiveness of your network (i.e. its latency) and how good your installation of VirtualBox is. Almost every action in RemoteBox requires a transaction across the network to the VirtualBox server. If the server's response is slow, then RemoteBox will be slow as a consequence. In short, a 1Gbit connection will feel snappier than a wireless or 100Mbit connection, etc.
  11. When I try to open the manual in RemoteBox, nothing is displayed... RemoteBox requires the xdg-open command which is part of the xdg-utils package. This package is usually installed by default on most distributions but you may need to install it, along with an appropriate PDF viewer.
  12. I run an older version of VirtualBox, what version of RemoteBox do I need? Older versions of RemoteBox are available for download, but should be considered unsupported. User submitted bug fixes for old versions of RemoteBox are still welcome. See the table below for reference. In addition, you can see which version of VirtualBox is support by looking at the 'About Menu' in RemoteBox.
    RemoteBox Version Required VirtualBox Version
    v1.6 and newer v4.3.x
    v1.4 - v1.5 v4.2.x
    v1.0 - v1.3 v4.1.x
    v0.6 - v0.9 v4.0.x
    v0.1 - v0.5 v3.2.x
    NONE v3.1.x and earlier editions
  13. Why is RemoteBox restricted to certain versions of VirtualBox? VirtualBox versions are generally of the form Major.Minor.Micro (e.g. 4.2.8). VirtualBox only guarantees API compatibility between versions if it is the Micro suffix which has changed. For example 4.2.8 is compatible with 4.2.0, but 4.2.1 is not compatible with 4.0.0. To reduce code complexity, RemoteBox only targets the latest version of the API at the time of release. RemoteBox will warn you, if you use an incompatible version of VirtualBox and even allow you to proceed, however you will certainly experience compatibility issues.
  14. I have a version of GTK2 older than 2.24, can I still use RemoteBox? Older versions of RemoteBox are available for download, but should be considered unsupported. User submitted bug fixes for old versions of RemoteBox are still welcome. See the table below for reference.
    RemoteBox Version Minimum GTK2 Version
    v1.6 and newer v2.24
    v1.2 - v1.5 v2.22
    v0.1 - v1.1 v2.16
  15. Does the client that RemoteBox runs on, need to be running the same operating system as the server that VirtualBox runs on? No, the client machine can be running a different operating system to the server. For example, you can have RemoteBox installed on a Linux machine and connect to a VirtualBox server running Windows.
  16. What operating systems does RemoteBox work on? RemoteBox is known to run on Linux, Solaris, Mac OS X, NetBSD, FreeBSD and others. It should run on any modern 'UNIX flavour', providing its dependencies are met.
  17. Does RemoteBox run on Windows? The short answer is no. I'm not aware of any Perl distribution for Windows that supports all of the modules required to run RemoteBox. If you do get RemoteBox to run natively on Windows, I'd love to hear from you. Please note, you can still connect to a Windows server running VirtualBox with RemoteBox.
  18. What server operating systems running VirtualBox, does RemoteBox support connecting to? Any operating system which officially runs VirtualBox. At the time of writing this is Linux, Windows, Solaris and Mac OS X. There are some operating systems which have non-official ports of VirtualBox such as FreeBSD and RemoteBox should work reasonably well with them, but they are not supported.
  19. Can I use RemoteBox to administer VirtualBox on the same physical machine? Yes. Just ensure the VirtualBox web service is running on the same machine and by default connect to http://localhost:18083 with RemoteBox.
  20. Does RemoteBox support Teleport? No, not at this time. It is unlikely RemoteBox will ever support this feature.
  21. Does RemoteBox support importing and exporting Virtual Appliance images (e.g. OVF)? No, not at this time. There are plans to support this in the future, although VirtualBox currently seems very picky about what appliances it will and won't import.
  22. Does RemoteBox support iSCSI LUNs? RemoteBox does not support connecting to iSCSI LUNs directly from its Virtual Media Manager. However you can use vboxmanage on the server to attach an iSCSI LUN, which will then be visible as hard disk in RemoteBox.
  23. Can I convert a hard disk image to another format? Yes. Open the VMM and ensure the “Hard Disk” tab is select. Choose the hard disk to want to copy and convert. Select the “Copy & Convert” option and select the format you require. You will be prompted where you would like to save the new image. This operation will not alter the source image.
  24. What is the default port that the VirtualBox web service runs on? The VirtualBox web service runs on port 18083 unless configured otherwise