Installation Guide

• Ubuntu 14.04
  • 1. Watch the Video
  • 2. Choose a cloud provider
  • 3. Install dependencies
    • Required
    • Optional dependencies
  • 4. Create database
  • 5. Configure application properties
  • 6. Configure Tomcat
    • Java OutOfMemoryError
    • Out of Memory: Killed process 31088 (java)
  • 7. Deploy the application to Tomcat
    • Stop tomcat
    • Download latest release
    • Copy WAR file to Tomcat
    • Restart Tomcat
    • Tail Tomcat logs
• Mac OS
  • Looking to contribute?
• Windows
  • Looking to contribute?

Supported Platforms

• Ubuntu 14.04 (recommended)
• Mac 10.6+
• Windows (whatever)

System Requirements

• Java 7 (required)
• Tomcat 7 or 8 (required)
• MySQL 5.5+ (required)
• SMTP server (optional)
• Chrome or Firefox (required)

Basic Instructions

1. Install pre-requisites
2. Download latest release
3. Create new database in MySQL
4. Grant permissions to new database user
5. Configure runtime properties (openboxes-config.properties)
6. Copy WAR file to Tomcat
7. Configure Tomcat
8. Start Tomcat
9. Watch the Tomcat logs during startup
10. Open application using Chrome browser