RemoteBox Logo

Open Source VirtualBox Client with Remote Management


RemoteBox Manual

RemoteBox 2.3 : PDF Manual

RemoteBox Installation

Installing on Arch Linux [EXTERNAL]
Installing on Debian / Mint / Ubuntu Linux
Installing on Fedora Linux
Installing on FreeBSD
Installing on Mac OS X
Installing on Mageia Linux
Installing on NetBSD
Installing on OpenBSD
Installing on OpenSUSE Linux
Installing on Red Hat Enterprise / CentOS / Oracle Enterprise Linux
Installing on Solaris / Indiana
Installing on Windows


When troubleshooting problems with RemoteBox, launching it from the command line may provide additional debugging 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 (
    1.2 (
    You're affected by a bug introduced in RemoteBox v1.8. Upgrading to at least RemoteBox v1.8.1 should resolve the problem.
  2. I get an error message on the command line similar to the following:
    “Incorrect parameter at <path>/SOAP/” line 1993”.
    This is a bug in the implemention of Perl SOAP Lite that you have installed. If it's not possible to upgrade your installation, it can be worked around by editing the offending line in SOAP/ as follows:
    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 to the VirtualBox server, even though I know my credentials are correct. It occasionally works but mostly doesn't. This is a compatibility issue introduced in Perl v5.18 and fixed in RemoteBox v1.8.1. It's recommended that you upgrade to at least RemoteBox v1.8.1 or alternatively downgrade your Perl installation to v5.16. To discover your Perl version, you can use 'perl -v' from the command line.
  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
    This is caused by a bug introduced in rdesktop v1.8.0 and rdesktop v1.8.1 when used with VirtualBox. It's recommended that you migrate to using FreeRDP instead if it's available for your distribution. Alternatively, ensure you are using at least rdesktop v1.8.2 or a version lower than v1.8.0
  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.
    This is caused by a bug introduced in rdesktop v1.8.0 and rdesktop v1.8.1 when used with VirtualBox. It's recommended that you migrate to using FreeRDP instead if it's available for your distribution. Otherwise, ensure you are note using versions 1.8.0 or 1.8.1 of rdesktop.
  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? First ensure that the VirtualBox Guest Additions are installed and running within the guest. If the guest OS does not have guest additions available, then changing the mouse type to "USB Tablet" should aid synchronization, providing the guest OS supports USB and tablets correctly.
  8. Can I use sound over RDP? Yes. The guest should have audio enabled and a virtual sound card assigned such as the 'Intel ICH AC97'. The sound card needs to be supported and working in the guest operating system.The host audio driver should be set to 'Dummy Audio Driver', otherwise the audio will try to be played through the server's physical sound card. In the RemoteBox preferences window under the Display tab you may need to add a parameter to the RDP client. For xfreerdp add the parameter '--plugin rdpsnd'. If you are using rdesktop instead then add the parameter '-r sound:local'.
  9. Can I use clipboard sharing over RDP? Yes. In the settings for the guest, set 'General -> Advanced -> Shared Clipboard' to Bidirectional. The guest must also have the Guest Additions installed and working. In the RemoteBox preferences windows under the Display tab you may need to add a parameter to the RDP client. For xfreerdp add the parameter '--plugin cliprdr'. If you are using rdesktop instead then add the parameter '-r clipboard:PRIMARYCLIPBOARD'.
  10. Can I use Remmina as my RDP client? No because Remmina does not support the required command line parameters and is really just a frontend built upon FreeRDP. As FreeRDP is supported by RemoteBox its use is recommended instead.
  11. Can I use KRDC as my RDP client? KRDC is not recommended because it does not support the required command line parameters for proper integration with RemoteBox. If you really want to used KRDC then configuring the RDP client in RemoteBox as follows will help:
    krdc rdp://%h:%p
  12. Is it safe to just close the RDP window while the guest is running? Yes, it's completely safe to do so. The guest will continue to run uniterrupted. To reopen the display, just select "Guest Display" from the toolbar
  13. I repeatedly get disconnected from the server. 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.
  14. 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 often helps, but not always. This is a bug in VirtualBox.
  15. Sometimes the interface is very slow. RemoteBox is completely dependent on the speed and latency of your network. Almost every action in RemoteBox requires a network transaction to the VirtualBox server. Heavily loaded networks or slow networks will affect the performance of RemoteBox. For example, RemoteBox will feel much more reponsive on a 1Gbit network rather than a slow Wi-Fi network.
  16. 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.
  17. 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. See the table below for reference. In addition, you can see which version of VirtualBox is supported by looking at the 'About Menu' in RemoteBox.
    RemoteBox Version Required VirtualBox Version
    V2.3 and newer v5.1.x
    v2.0 - v2.1 v5.0.x
    v1.6 - v1.9 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
  18. 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.
  19. 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
  20. Does the OS that RemoteBox is installed on, need to be the same OS as the VirtualBox server? 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.
  21. Which operating systems does RemoteBox run on? RemoteBox is known to run on Linux, Solaris, Mac OS X, Windows, NetBSD, FreeBSD and others. It should run on any modern flavour of UNIX providing the required dependencies are installed.
  22. Which 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.
  23. Can I use RemoteBox to connect to 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.
  24. Does RemoteBox support Teleport? No, not at this time. It is unlikely RemoteBox will ever support this feature.
  25. 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.
  26. 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.
  27. What is the default port that the VirtualBox web service runs on? The VirtualBox web service runs on port 18083 unless configured otherwise
  28. Will you port RemoteBox to Android or iOS (iPhones)? Unlikely as a version for Android/iOS would require almost a complete rewrite, but I'd love to be proved wrong.