- 1 ReactOS testing overview and FAQ for beginners
- 2 Tutorial: Getting a stable software stack with ReactOS on VirtualBox.
- 2.1 Configuring VirtualBox
- 2.2 Installing guest additions and basic drivers
- 2.3 Installing additional software
- 2.4 Checking 3D
- 2.5 Recommended end user software
ReactOS testing overview and FAQ for beginners
Following secion is for ReactOS users who intend to test software with ReactOS and report the results back to the community. It is built as a FAQ supposed to cover the typical questions of people new to testing ReactOS. This section does not cover the answers in detail but rather links to selected existing detail pages in order not to duplicate that information.
See also: Testing Introduction
What is the current version of ReactOS I should test?
- If you prefer the most stable version and do the tests only for you own curiostity, you may use the latest release, available on the official download page.
- (Preferred:) If you want a rather stable version, want to do regression tests for the upcoming release and want to report found bugs use the current release candidate, whose download link is on the current release testing page, such as f.e. Tests for 0.4.10 The navigation bar below shows the releases, including the latest one being tested when there are ongoing tests.
- If you know the feature you testing is not yet contained in the latest release or if you are asked to check a bug is still contained in the latest nightly build, download the nightly build. (Tip: Click on the left (<) arrow to go back to a revision that is already available for download.)
How to set up ReactOS so it runs stable?
Depending on what you intend to test (software vs. hardware and drivers) you may set up ReactOS either on real hardware or in a Virtual Machine. Whenever possible use a VM because this eases testing a lot as you can just reset your VM once you crashed or destroyed your ReactOS installation during a test. For details see here:
- Installing ReactOS which explains pre-requisites for installations on real hardware and on virtual machines.
- See the chapter Getting a stable software stack with ReactOS on VirtualBox below which covers the option with VirtualBox in detail and some typical drivers and software as well.
- The VirtualBox page covers more advanced topics.
How to set up a good testing/logging environment?
So you have become aquainted with ReactOS and found problems for which you want (or were asked) to provide debug logs. There are several ways to create debug logs:
- The easiest way is to start (in the boot manager) ReactOS with the option "ReactOS (Log file)". This will create a log file in the OS installation directory within the VM, such as f.e. C:\Reactos\debug.log. Just copy the content to your host and attach as text file to the JIRA ticket.
- If you encounter OS freezes, blue screens or other situations where you cannot grab the created log after the incident, you may use the option to create live log files using putty or similar tools.
- A layman's guide - How to get a debug.log
- Getting debug output
- Youtube: ReactOS - getting debug log with putty + backtrace - quick and concise.
- In-depth technical background can be found on the Debugging page.
Where to post the results of my tests?
This depends on the ROS version you tested (official release, release candidate or nightly build) and whether you want to report a success or an issue.
- If you want to report some successfully running application or game, post this in the forum under Epic Win! Specifically for games you can also add it to the Games testing page.
- If your findings concern the last official release, you can file a bug in JIRA, but be prepared to be asked to check whether this bug still exists in the latest nightly build, as release versions are usually something like 1-4 months behind the master (the latest developlent version), so your findings may be somewhat outdated and the issue possibly already fixed. Please do not edit the testing page for an already released version any more.
- If your findings concern a release candidate (e.g. if you did a regression test checking for issues introduced in this release) then you can add your software to the "Stuff not in the Downloader list" section of the latest testing page for this version (e.g. Tests for 0.4.10). Be sure to read the guidlines on the top of this page and check your software is not already on the list (with a similar version). It is recommended to create separate JIRA tickets for every issue you came across, of course only for issues likely related to ROS (that is, not a bug in the software itself which also appears under Windows).
- No matter what version and what (legal) software you tested you are free to post your results on your personal wiki page (e.g. "User:<yourusername>") or create a forum thread. Using a wiki page is recommended if you intend to regularly update this information, a forum thread (or JIRA issue) is better for starting a discussion about a certain found issue.
How to create good bug reports?
This is covered well here on the wiki.
- Testing Central contains information about requesting a certain software to be regression tested regularly and how to do this.
Tutorial: Getting a stable software stack with ReactOS on VirtualBox.
This tutorial aims at providing beginners and software testers with a step by step guide for creating a ReactOS installation in a VirtualBox which works as seamlessly as possible. While setting up ReactOS in a VirtualBox somehow is rather easy, getting all the drivers, guest additions and software settings right can be a bit tricky, especially since some decisions may cause Blue Secreens (BSOD) or make VirtualBox snapshots difficult.
This tutorial does not cover each and every software, only a "should have" driver and software stack and some applications I use in order to test multimedia and 3D settings or which I consider useful for end users.
Disclaimer: Everything written here is based on my own experience and ReactOS might behave differently on other computers. I am not someone "official" either, so don't blame me if something doesn't work as described.
This section is based on https://reactos.org/wiki/VirtualBox, but covers more details. It assumes you have a ROS boot image. Tested with VirtualBox 5.2.26 and 6.0.22 releases.
|Attention: At the time of writing (with ROS 0.4.13 or 0.4.14 RC) it's recommended not to use VirtualBox 6.1 as it dropped support for Direct3D acceleration for anything below Windows 7 and thus for ReactOS (CORE-17105). However, if you don't need 3D support you may use VBox 6.1.
And early 6.0.x versions had an issue with the AC97 sound driver (CORE-16019). 6.0.22+ should be fine though.
- Create a new virtual machine based on Windows 2003 (32-bit), as this the target for ReactOS. Note that the type is not really important, the actual VM settings are.
- Create a virtual hardisk. I use a 20 GB (dynamically allocated) as this should be enough for tests.
- Once the VM has been created, open and adjust its settings:
- Tab Advanced: Enable Bidirectional shared clipboard. This helps copying URLs, registration codes and text around.
- Adjust your memory settings. At least 256 MB is recommended, but some software might require far more than that. I chose 50% of my real memory.
- There is no need to enable I/O APIC as Multithreading is not supported in ROS 0.4.x yet.
- Leave all other settings as they are (1 processor, hardware virtualization on)
- Set video memory to 32MB. Do NOT use more than 32MB as this will cause the Guest additions to prevent ROS from starting.
- For this multimedia-centric tutorial enable 3D and 2D acceleration, that is, if your graphics card is not from the last century.
- Use the "Empty" IDE controller to assign the ROS boot image (.iso) to the "DVD" drive.
- Ensure that the audio controller is "ICH AC97". ROS ships with a driver for this controller.
- Tab "Adapter 1": Open the "Advanced" section and choose the adapter type "PCnet-FAST III". Again, ROS has a driver for this.
Section "Shared Folders"
- Add a shared folder and select "Auto-mount". I also chose "Read-only" as my driver is on an NTFS drive. (I haven't tested write access yet.)
That's it. Now boot ReactOS from the ISO and follow the instructions. I recommend increasing the initial screen resolution. The boot loader settings can remain as they are. I leave the most settings unchanged, only modifying the keyboard layout to personal taste.
Installing guest additions and basic drivers
After a few minutes and two restarts later, ReactOS is installed and will ask you to provide hardware drivers. You can cancel these dialogs or click through - ReactOS will not (yet) find drivers. That's expected.
CHECKPOINT: You may want to create a snapshot in VirtualBox in case something goes wrong later.
NOTE: At this point you can create snapshots both while ROS is running or after it is shut down and both should work well.
Installing the guest additions
- Do a restart and on the boot manager, press F8, select "Safe mode" and then start "ReactOS".
- In the VirtualBox menu, choose "Devices" -> "Insert guest additions CD image"
- Navigate to the "VBOXADDITIONS" drive and start "VBoxWindowsAdditions.exe".
- Leave the target directory unchanged unless there is a reason to change it.
- Enable "Direct3D support". That's why we had to switch to the "Safe mode".
NOTE: If you get a BSOD for "VBoxDisp.dll" you likely have chosen more than 32MB graphics memory. Recover your last snapshot, shutdown ROS (if necessary) and change that setting before trying again.
After the restart you may want to adjust the display resolution and color settings.
Installing additional drivers
- In the ReactOS application manager (RAPPS), section "Drivers", install the AC97 driver. When prompted for the target directory, choose "C:\ReactOS" (unless you chose a different OS folder name).
- Open the device manager in under system settings -> system, tab "hardware", select the "Multimedia audio device". It should be the only remaining "Unknown device". In the context menu, select "Update driver" and follow the wizard. Installation should be successful.
- Restart TWO times. The first reboot may take an extra 20 seconds or so. Installation was successful when, after the second restart you hear the ReactOS welcome sound. Note that sometimes a third reboot is needed and that installing some other software beforehand may make the sound not work at all, thats's why I recommend installing this driver early.
CHECKPOINT: I recommend shutting down ROS and create another snapshot in VirtualBox. Note that when recovering a snapshot later, your screen resolution may be reset to VGA but you can drag the windows larger or re-set the resolution in ROS. This seems to happen randomly.
ATTENTION: At this time, when you create the snapshot while VBox is running and later return to that snapshot, ROS will show a BSOD. The sound driver causes this, unfortunally. You have to "Reset" the machine in this case, after which ROS will boot without problems. But there is no use in a snapshot of a running ReactOS if the running OS cannot recover.
Installing additional software
From now on, you may focus on whatever you think most important. I can give some suggestions:
Installing Firefox and Flash
ATTENTION: Firefox 53 and newer will not work on ReactOS 0.4.x, as support for WinXP has ended. Neither does (unfortunately) FF 52.3.0 ESR or any other release above FF 48, as my tests showed.
After installation the first thing you need to do is enter the Firefox settings and disable auto-updates. (You may ignore the balloon tab telling you about a newer, already downloaded version.)
ATTENTION: If you either open the about dialog or forgot to disable auto-updates, Firefox will quickly update itself to a newer version which will not run. Never ever open the "About" dialog - it initiates the update even if auto-update is off (which I find counter-intuitive)!
You may then install Addons. However it will be very difficult to find addons for pre-FF51 versions (old addon type) as they have been basically completely removed from the official repository. Maybe you are lucky to have a backup of the installation files?
Firefox 48 can playback HTML5 videos on Youtube, but there is no sound. In order to get some videos and live-streams working with sound, Flash can be installed. In most release versions except ROS 0.4.7 and 0.4.12 you can use the online installer from , which does work reasonably well. Ensure you select Windows Server 2003 as target OS.
With ROS 0.4.7 and ROS 0.4.12 you will need to use the archived, well-hidden offline installers, currently under following link (scroll down to "Flash Player archives"): https://helpx.adobe.com/flash-player/kb/archived-flash-player-versions.html#main_Archived_versions These huge 400MB-downloads contain versions for all OS, among them a Windows version (e.g. "flashplayer27_0r0_170_win.exe"). This offline installer works well.
CHECKPOINT: How about another snapshot now? (Better shut down ReactOS beforehand.)
ATTENTION: I found that recovering to snapshots created at this time or later with ROS being shut down can sometimes cause ROS to start with graphics problems (light blue screen with some artefacts on top). It is not clear exactly what causes this, but resetting the VM helps.
Installing and configuring VLC player
As of ReactOS 0.4.14 the VLC player 3.0.7 can be downloaded from the application manager (RAPPS) and works out of the box. You can leave the video output set to "Automatic".
In older versions of ReactOS (I believe 0.4.8 and below) it was necessary to configure VLC as as following before playing any video:
- Once VLC is installed, open it without a video first.
- In the menu, open the "Tools" -> "Preference" and in the bottom left corner, switch to "All" settings. This is important because VLC will freeze trying to open the Video settings in the graphical setup.
- In the list now shown on the left, select Video -> Output modules (near the bottom).
- Change the Video output module from "Auto" to "OpenGL video output" or "Direct3D video output"
I found OpenGL to give better video performance. I haven't tested all, but "DirectX (DirectDraw)" and "Direct2D" do not work for me.
OpenGL, Mesa 3D and Google Earth
If you followed this tutorial, OpenGL should be already working. You can install Furmark (e.g. version 1.1.7) and check it works, albeit slowly.
In the ReactX diagnosis application (dxdiag), the DirectDraw tests fail. This can be fixed by installing the Mesa driver. However, since Mesa 3D is a non-accelerated 3D driver this will further decrease the performance in FurMark, so it may not be what you really want. If you still want to try:
- In the application manager, within "Libraries", select and install the "Mesa3D Graphics Library".
- Carefully read the setup information: The non-accellerated OpenGL library will replace any other OpenGL driver if set as default. In order to satisfy the dxdiag DirectDraw test, it must be set as default.
- Open the ReactX diagnosis application (dxdiag) and check the DirectDraw test works. (Direct3D does fail for me.)
If you intend to install and use Google Earth, you *must* currently install the Mesa drivers, because otherwise Google Earth will make ReactOS freeze on startup. If you have them installed, however, Google Earth will run, albeit with not the framerate you might be used to.
Recommended end user software
Here is a list of some end user software which I found to work well on ReactOS 0.4.x. (It does not include debugging tools and such.) See the test page for the version your are installing for more details. Games are deliberately not listed here, but you find games tests on this wiki page.
- 7zip (packer, open source, in RAPPS)
- Notepad++ (editor, open source, in RAPPS)
- Adobe Reader 7.0.7 (PDF reader, Freeware) works well, ... if you are able to get this 2006 version nowadays.
- Adobe Reader 9.3.0 (PDF reader, Freeware) also works well. Note that you must use the default theme with both versions of Adobe Reader as up to now the Lautus theme will cause freezes when using their toolbars.
- SumatraPDF 3.1.1 (PDF reader, open source) is reported to work well.
- Scribus 1.4.6 (desktop publishing, open source) is reported to work with only minor glitches.
Note: LibreOffice 5.2.6 installs for me but is so slow I consider it almost unusable. I haven't tested Apache OpenOffice.
- Faststone Image Viewer, current version (image viewer with editing functions, "Free for home users")
- FS IV has a minor display problem in thumbnails view, but works well otherwise.
- IrfanView 4.44 (image viewer, Free for home users) works but before installation requires to download and extract the VisualC++ 6 runtime (e.g. from RAPPS) and manually copy the DLLs to C:\ReactOS\system32 (or your OS operation folder).
- RawTherapee 4.2.1 for WinXP works, unlike newer versions of this RAW processing software. So stick with this old one for now.
- Aquasoft Diashow Studio 6.4.03 (slide show/presentation, commercial) works when using software mode for playback. Note that other versions (including the free c't edition 6.6.03) have major issues, as far as I tested. The even older v5.7 should work as well.
- VLC 3.x (video player, open source, in RAPPS), works well, see above
- Winamp 2.9.1 (MP3 and music player, Freeware) works with minor GUI display issues.
- Google Earth 7.1 (virtual globe, Freeware), installed via the offline installer(!) works in OpenGL mode, but requires Mesa driver to be installed. Performance in areas with 3D cityscapes might be poor and search is not working, otherwise it is completely usable. Note bug CORE-17106 on 0.4.14 RC!