RemoteBox Logo

Open Source VirtualBox Client with Remote Management

Documentation

Manual

RemoteBox 1.7 : PDF Manual

FAQs

  1. 6.1.1 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.
  2. 6.1.2 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.
  3. 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 on Windows, please let me know. You can however connect to a VirtualBox server running Windows
  4. Does RemoteBox run on my favourite flavour of 'UNIX'? It should be possible to get RemoteBox to run on any reasonably modern flavour of UNIX, or UNIX-like operating system. You may however need to manually compile and install the required dependencies yourself, rather than having them conveniently available in a repository.
  5. Does RemoteBox support Teleport? No, not at this time. It is unlikely RemoteBox will ever support this feature.
  6. 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.
  7. 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.
  8. 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.
  9. Why is RemoteBox restricted to certain versions of VirtualBox? VirtualBox versions are generally of the form Major.Minor.Micro (e.g. 4.2.1). VirtualBox only guarantees API compatibility between versions if it is the Micro suffix which has changed. For example 4.2.1 is compatible with 4.2.0, but 4.2.1 is not compatible with 4.1.0. To reduce code complexity RemoteBox only targets the latest version of the API at the time of release. It will warn you, if you use an incompatible version but you may experience problems if you choose to continue.
  10. 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.
  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, however if it is not installed, please install it along with an appropriate PDF viewer.
  12. I run an older version of VirtualBox, what version of RemoteBox do I need? Old versions of RemoteBox are downloadable from the website but should be considered unsupported, although user submitted bug fixes are welcome. See the table below for reference.
    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. I have a version of GTK2 older than 2.24, can I still use RemoteBox? Old versions of RemoteBox are downloadable from the website but are no longer supported or maintained. 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
  14. 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.
  15. I get an error message on the command line similar to the following “Incorrect parameter at <path>/SOAP/Lite.pm” line xxxx”. What can I do? This seems to be a bug in your particular perl-Gtk2 implementation. If possible upgrade your version of perl-Gtk2. You can also work around this by editing the SOAP/Lite.pm file and changing the line from:
    die “Incorrect parameter” unless $itself =~/^d$/;
    replace with
    die “Incorrect parameter” unless $itself =~/^d*$/;
    
    (Note the addition of the asterisk *)
  16. I'm using Perl v5.18 or newer and can't seem to be able to login, what's wrong? Changes in Perl v5.18 introduced an incompatibility with RemoteBox v1.6 and earlier which prevents logins from working correctly. The recommendation is to upgrade to RemoteBox v1.7 or newer.
  17. What is the default port that the VirtualBox web service runs on? The VirtualBox web service runs on port 18083 unless configured otherwise
  18. I repeatedly get disconnected from the server, what's wrong? Unless you have a particularly bad network, you probably either have a low timeout configured on the web service, or you have disabled the heartbeat in RemoteBox. Please ensure the heartbeat is enabled in RemoteBox (File->Preferences->Heartbeat). Ensure that the web service has timeouts disabled or is not configured lower than 60 seconds.
  19. When using rdesktop it gives me 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 1.8.0 and newer have severe problems when connecting to VirtualBox. Either downgrade Rdesktop to an earlier version or use the recommended FreeRDP client.
  20. Sometimes the interface is slow, why? RemoteBox is completely dependent on the responsiveness of your network and VirtualBox. Almost every action in RemoteBox requires a transaction to the VirtualBox server. If the server's response is slow, then RemoteBox will be slow as a consequence.