Skip to content

Latest commit

 

History

History
25 lines (22 loc) · 2.34 KB

general-installation-guide.md

File metadata and controls

25 lines (22 loc) · 2.34 KB

Installation Guide

You have 4 options:

  • If you want just to see the app, take a look at one of our environments like DEV. You can use admin/admin credentials.
  • You can start a local virtual environment without pulluting your OS and without tedious configuration. See our JTalks VM project
  • If you'd like to run it locally, install the project from binaries (war file), see below.
  • If you want to contribute, you may want to build it from sources.

So if you want to run the app locally (from binaries or sources), you need to install basic environment:

####Installing from Binaries

  • Download latest version from our repository, you're interested in *.war files inside of directories.
  • Rename it to poulpe.war, put it into your $TOMCAT_HOME$/webapps (don't start Tomcat yet).
  • Now you need to configure DB access and other stuff. It's done via configuration file, the sample can be found here, its name should be the same as the war-file name and it should be placed into $TOMCAT_HOME/conf/Catalina/localhost. For more details, read comments inside of the file per se.
  • What's left is to start the Tomcat which is described in basic environment installation
  • You may want to install Forum as well to see how Poulpe impacts it.

####Building from sources

  • You'll need to install a dev environment (linux instructions, windows instructions). Alternatively to Git, you may want to download the sources directly as a zip if you don't have Git and you don't want to install it. This won't allow you to contribute to the project though.
  • Clone the project: [email protected]:jtalks-org/poulpe.git. Now you can work with that project from your IDE.
  • If you want to deploy it from command line.. Step into the folder and build it: mvn clean package
  • Repeat everything from Installing from Binaries but instead of downloading war-file, just grab it from poulpe/poulpe-view/poulpe-web-view/target