Install on my Computer¶
This section describes how to install Enonic XP on your own computer. If you have any problems, please look at our Troubleshooting section.
Note
General Requirements
- Any OS supporting Java (Mac, Linux, Windows etc)
- Java JDK 1.8 (update 40 or newer)
- At least 1 GB of available memory
- HTTP port 8080 should be available (this can be changed if needed, see Configuration)
Install Java¶
Warning
To run Enonic XP, you need Java Development Kit (JDK) 1.8.40 JDK or newer.
Check JDK Version
If you’re not sure what JDK version you have (or even if you have one), run the following in your terminal/shell:
javac -version
This should produce a response such as: “javac 1.8.0_60”
Having problems with your existing Java installation? Check out our Troubleshooting Java documentation.
Optionally Install Java
If it turns out you’re on the wrong java version, follow these steps
- Download it from http://www.oracle.com/technetwork/java/javase/downloads/index.html

- Follow the instructions for your respective operating system
Download Enonic XP¶
Enonic XP is available in a simple universal distribution file - running on all plaforms (Windows, Linux, OSX etc)
- Download Enonic XP distribution
- Unzip the file to a suitable location
Hint
Commandline Ninja version
curl -O http://repo.enonic.com/public/com/enonic/xp/distro/6.2.1/distro-6.2.1.zip
unzip distro-6.2.1.zip
cd enonic-xp-6.2.1
Next - let’s get the server started
Start the server¶
Now that the software has been downloaded, you’re ready to start the server - start the respective file from command line.
Linux and OS X:
[XP Installation Folder]/bin/server.sh
Windows:
[XP Installation Folder]\bin\server.bat
This will start Enonic XP. When successfully started, the following will appear at the end of the log:
12:53:14.302 INFO c.e.x.l.framework.FrameworkService - Started Enonic XP in 7378 ms
Log In¶
- Point your browser to
http://localhost:8080
- Log in with username
su
and passwordpassword
.
After logging in you should see the following screen:

Install Superhero Blog¶
This is a simple blog, basically emulating Wordpress - even using one of their nice themes. Follow these steps to try it out:
Deploy App
- Download the Superhero Blog Application
- Copy the application file into [XP Installation Folder]/home/deploy/
Start blogging
- From the Admin interface, verify that Superhero Blog has been installed using the Applications App, it should look something like this:

- In the Content Manager app you will find a superhero site and all it’s content

Watch Video
To learn quickly how Enonic XP works, and especially the Superhero Blog Application, watch this video:

Full source code for the Superhero Blog can be found on GitHub: https://github.com/enonic/app-superhero-blog
Next Steps¶
Congratulations on getting started :-)
If you’re ready for some more fun, we recommend looking into the following:
- Watch the Platform Video
- Hook up with the community on our forum
- Build your first Application with My First App
- Get under the hood of the Content Domain