FAQ Troubleshooting

Problems launching VoyantServer

Normally when you launch VoyantServer by clicking on VoyantServer.jar you will see the VoyantServer application window launch, with some information in the console window, and – if all goes well – a browser window will appear with the main Voyant page. If that doesn't happen, the first thing to do is to look at the VoyantServer console to see if there are useful error messages.

Here's an example:

*** Starting Voyant Server – Web page will open automatically when ready ***
Using Free AdminPort=34000
Server Starting
2018-03-26 12:59:45.812:INFO::main: Logging initialized @507ms
Jetty Version: 9.3.z-SNAPSHOT
http://*:8888
Jetty starting up ... please wait
2018-03-26 12:59:47.844:INFO:oejs.Server:main: jetty-9.3.z-SNAPSHOT
2018-03-26 13:00:05.391:WARN:oejut.QueuedThreadPool:qtp1742101-11: 
java.lang.OutOfMemoryError
...

As this suggests, there's a memory issue here. When this happens at startup it usually means too much memory has been requested by the machine, given the other processes that may be running. The solution is usually to decrease the initial memory setting by 1) quitting VoyantServer; 2) opening the server-settings.txt file in the same directory; 3) editing the line for RAM and trying 512 or 256 instead of 1024; saving the file; 4) relaunching VoyantServer.