Introduction
I have been an enthusiastic StatET user since 2018, and whenever I install a new version of Eclipse, StatET, or R on Windows, there are always a few small technical hurdles to overcome. Last year — and again today — I ran into the familiar “RMI Registry port” error when launching R under StatET. I’m taking this opportunity to share the solution I found, so others can save time when they encounter the same issue.
Background: StatET 4.11.0 and Recent Changes
Recently, Stephan (the StatET maintainer) announced StatET 4.11.0. Highlights include support for R 4.5 and ANSI escape sequences in the R console, among other minor improvements. Below is an excerpt of his message, with links inserted at appropriate points:
Dear StatET users,
I am pleased to announce StatET 4.11.0, a new version of the Eclipse-based IDE for the R language.
StatET 4.11.0 Release AnnouncementThis release provides support for R 4.5, support for ANSI escape sequences in the R console, as well as several other minor improvements. Details of these and more noteworthy changes are presented here:
Noteworthy Changes in StatET 4.11The new version is available for Eclipse IDE 2025-06:
Eclipse IDE 2025-06 Download.
StatET 4.11 officially supports R 4.3 – 4.5, but other versions of R may work too.To install the new version, you can use the following update site:
https://download.eclipse.org/statet/releases/4.11/E202409
For other download options, please check the download page:
StatET 4.11 DownloadsIf you want to use the advanced console (RJ) with R, you need the R package
rj
for your R version as before. The packages for GNU R (RJSrv4GR) are not part of the Eclipse StatET project; for installation see the instructions at the project site:
RJ Server Installation Instructions
The R packages with version numbers 4.0.x (for RJ 4.0) are also compatible with StatET 4.11. I recommend updating to the latest release 4.0.11 if you have not done so yet.Thanks to everyone who has contributed to this release.
Regards,
Stephan
With these updates in mind, you may upgrade to StatET 4.11.0 on Eclipse 2025-06 and R 4.3–4.5 (or your preferred R version), but you may still encounter the RMI registry port conflict when launching R via StatET, especially on Windows.
The RMI Registry Port Error
When you start Eclipse (with StatET installed) and launch an R session, you may see a dialog like this:
Error:
‘Launching R 4.3.1’ has encountered a problem.
RMI Registry at port 51199 could not be started. The new process terminated
with exit value 1.
commandLine=“C:...
jre” 51199
-J-Djava.rmi.server.codebase=file://…
-J-Djava.rmi.server.hostname=127.0.0.1
Typically, this means that the default RMI Registry port (often 51199) is already in use on your machine, or the port range is too narrow. StatET’s RJ console tries to start an RMI registry on a port in a small default range, and if all ports in that range are occupied, you get this error.
Solution: Expanding the RMI Port Range
The workaround is to configure StatET to use a wider port range for the RMI registry. You can do this via the StatET advanced configuration. Specifically, add or modify the property:
org.eclipse.statet.jcommons.rmi.registry.TcpPort=51100-51299
This expands the default port range from 51100–51199
to 51100–51299
, giving StatET more options to bind the RMI registry.
Step-by-Step: Adjusting the Port Range
- Identify the StatET Config Location
Depending on your Eclipse installation, StatET stores settings in your workspace or in the Eclipse installation’s plugin configuration. Consult:
StatET Advanced Configuration
for your specific version.Open the
config.ini
in the folderC:\Users\[my_user_name]\.eclipse\org.eclipse.platform_[my_eclipse_version]_win32_win32_x86_64\configuration
.
Example - yourconfig.ini
may look like this:# This configuration file was written by: # org.eclipse.equinox.internal.frameworkadmin.equinox.EquinoxFwConfigFileParser # Fri Nov 22 14:59:28 CET 2024 eclipse.p2.data.area=@config.dir/../p2/ osgi.sharedConfiguration.area=file\:configuration/
- Add or Edit the Property
- Add the line:
org.eclipse.statet.jcommons.rmi.registry.TcpPort=51100-51299
- If multiple key-value pairs are present, ensure each is on its own line, and do not include confidential local paths.
- Add the line:
- Restart Eclipse
- After saving configuration edits, restart Eclipse to apply the new port settings.
- Launch R via StatET
- Try launching R again. If the previous conflict was due to the narrow port range, StatET should now successfully start the RMI registry on a free port within 51100–51299.
Troubleshooting Further
- If you still see a port conflict, you can further expand the range, e.g., `51100-52000`. However, a very large range may be unnecessary; choose a small range that avoids conflicts on your system.
- Ensure no firewall or security software blocks RMI registry ports.
- Verify that your R version is compatible with StatET 4.11.0 (R 4.3–4.5 officially supported). If you use a different R version, you may need a compatible
rj
package:- Install or update the
rj
package in R:r install.packages("rj")
- Follow instructions: RJ Server Installation Instructions
- Install or update the
Conclusion
Encountering the RMI registry port error can be frustrating, but expanding the default port range in StatET’s configuration is usually enough to fix it. By following the steps above—adding org.eclipse.statet.jcommons.rmi.registry.TcpPort=51100-51299
(or a suitable range) — you should be able to launch R sessions without the “port 51199 could not be started” error.
Happy coding with StatET and R on Windows! Feel free to leave feedback or share other tips for avoiding port conflicts.