Structr on Windows

Search
Feedback

To run Structr on Windows, follow these instructions for a full manual installation and start.

Prerequisites

Make sure you have Java JDK 8 installed on your machine. The standard JRE package which is installed by default on most computers is not sufficient because it doesn’t contain the Java Compiler (javac.exe).

Check Java version

You can check the Java version with

C:\>where java
Download and install JDK 8

If you get C:\Windows\System32\java.exe as response, go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html and download the JDK version for your operating system (32 or 64 bit).

Follow the installation instructions from here:
http://docs.oracle.com/javase/8/docs/webnotes/install/windows/jdk-installation-windows.html

Install and configure JDK

Please note: The images in this article show JDK 7 but JDK 8 is required for Structr 2.0 and later.

Now you need to activate the installed Java version. Open the Java Runtime Environment Settings from the Java Control Panel, found in Control Panel > Programs:

Click on “Find” and navigate to the location of the newly installed JDK:

Click “Next”, select the entry found, click “Finish” to confirm the selection.

Deactivate the old and activate the new Java location:

Change %PATH% variable

In order to make the new Java version available for running Structr, it’s good practice to add it to the global %PATH% environment variable.

Go to “Control Panel > System and Security > System”, click the “Advanced” tab and click on “Environment Variables”.

Click on “Edit” and change the value to reflect the new JDK location:

IMPORTANT: Make sure the path to your new JDK location is at the very beginning of the path variable!

To confirm new settings, open a new Command Prompt window (cmd) and type

C:\Users\IEUser\>where java

and

 C:\Users\IEUser\>where javac

Both commands should return the paths to the JDK executables java.exe and javac.exe, similar to these:

C:\Program Files\Java\jdk1.7.0_79\bin\java.exe
C:\Program Files\Java\jdk1.7.0_79\bin\javac.exe

Important Note: Unless you have javac.exe available in the path, you’re not running a full JDK, and Structr will not run at all, showing errors when trying to compile the dynamic schema at startup (you will see a lot of NodeExtender exceptions in the log).

Install Structr

Download and install Structr

Download the latest Structr distribution file (…dist.zip) from here:

https://oss.sonatype.org/content/repositories/snapshots/org/structr/structr-ui/

Unzip the distribution archive

Move the file to the location you want Structr to run from, here we choose the Desktop folder. Unzip the file (typically with “Extract here”).

Unzip the static resources

Enter the directory which was created:

C:\Users\IEUser>cd structr-ui-1.1-SNAPSHOT-201505231136.f596a

Extract the “structr/” folder from the JAR file with the “jar” command:

C:\Users\IEUser\structr-ui-1.1-SNAPSHOT-201505231136.f596a>jar xvf structr-ui-1.1-SNAPSHOT-201505231136.f596a.jar structr

This will create a folder named “structr” containing the static resources needed for the backend UI.

Note: In some folders special rights are necessary to extract the jar. The command prompt has to be run as administrator in that case.

Note: The folder name may vary, depending on the version you downloaded. The folder and JAR file names contain the module name (structr-ui), the version (1.1-SNAPSHOT), the build date (201505231136) and the first five characters of the git commit uuid (f596a).

Start Structr

Start Structr with the following command:

java -cp lib/*;structr-ui-1.1-SNAPSHOT-201505231136.f596a.jar org.structr.Server

This will start a new java process, including all libraries in the lib folder and the structr JAR file itself, starting the main class “org.structr.Server”. A new configuration file named “structr.conf” will be automatically created upon first startup. You should see startup messages similar to the following figure:

You can stop the Structr process with “Ctrl-C”.

Verify installation

To verifiy Structr is running properly, go to http://localhost:8082/structr and check if you can see the login prompt.
Login with admin/admin and get started with your application.

After login, you should see the following: (**On newer versions the Welcome-Page is not included in the seed anymore - so you will not see this page**)

Graph-Browser

About this article
Last change 2017-01-13
Topics Structr 2.0