Wings workflow system
Java JavaScript HTML Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Wings 4.0-SNAPSHOT

1. Java JDK 1.6+ (
2. Maven 2/3 ( -- To install from source)
3. Tomcat 7+ (
4. Graphviz (
5. Unix/OSX environment (The portal will run in Windows, but we don't have windows 
   compatible domains right now)

Alternative A) Use our Docker image (you need to have Docker installed:
           - docker pull kcapd/wings-base
Or build it with additional software using our proposed Docker files. See for additional instructions.

Alternative B) Follow the steps below to install WINGS locally:
1. Get war file. Choose from one of the options below:
	a) If installing from source. Download source from
	   - mvn install (Do this if you are installing from source and don't already have a war file). If you find any encoding issues, try `export MAVEN_OPTS= -Dfile.encoding=UTF-8` before the mvn command
	   - This will create a wings-portal-<version>.war file in portal/target
	b) Or, Download from

2. Move the war file to a Servlet container (Tomcat) and rename to wings-portal.war
	- $ mv /path/to/wings-portal-<version>.war /path/to/tomcat/webapps/wings-portal.war

3. Setup an admin user in /path/to/tomcat/conf/tomcat-users.xml
	- Wings admin users need to have the "WingsUser" and "WingsAdmin" roles
	  Example: (The following needs to go inside the <tomcat-users ..> Section.

<user name="adminUser" password="adminPassword" roles="WingsUser,WingsAdmin" />

4. In /path/to/tomcat/conf/server.xml, add 'readonly="false"' to the UserDatabase Resource 

<Resource name="UserDatabase" ...  readonly="false"/>

5. Add the following to the <Context> section

<ResourceLink name="users" global="UserDatabase" />

6. Start tomcat
	- $ /path/to/tomcat/bin/

7. Login to the server from http://<your-server-name>:8080/wings-portal/login
	- Note: 8080 is the default Tomcat port, but this can be changed in server.xml

8. After first Login, go to $HOME/.wings directory and open
	- Change /path/to/dot (graphviz) if it is set incorrectly
	- Check that the server name is set correctly
	- (Optional) Change any other settings if needed

9. Manage users at http://<your-server-name>:8080/wings-portal/users/common/list
	- From this UI, you can add or remove more users.

10. To see a list of domains to download, please go to the "Manage Domains" interface
	- To Import a domain: From the "Manage Domains" interface, do the following:
		- Add -> Import Domain
		- Enter Domain Location: the url (or path) to the domain zip file
		- Note that some domains might require installation of infrastructure software on your server