Setup instructions: (for those wishing to just follow a set of commands please scroll to end of the file) Hosting webserver requirements: Install apache2 and the following packages: ii zip 2.32-1 Archiver for .zip files ii p7zip 9.04~dfsg.1-1 7zr file archiver with high compression ratio ii p7zip-full 9.04~dfsg.1-1 7z and 7za file archivers with high compression ratio ii libapache2-mod-php5 5.2.12-0.dotdeb.1 server-side, HTML-embedded scripting language (Apache 2 ii php-apc 3.0.19-2 APC (Alternative PHP Cache) module for PHP 5 ii php-pear 5.2.11-0.dotdeb.1 PEAR - PHP Extension and Application Repository ii php5 5.2.11-0.dotdeb.1 server-side, HTML-embedded scripting language (metapack ii php5-cli 5.2.12-0.dotdeb.1 command-line interpreter for the php5 scripting languag ii php5-common 5.2.12-0.dotdeb.1 Common files for packages built from the php5 source ii php5-curl 5.2.12-0.dotdeb.1 CURL module for php5 ii php5-dev 5.2.11-0.dotdeb.1 Files for PHP5 module development ii php5-gd 5.2.12-0.dotdeb.1 GD module for php5 ii php5-memcache 5.2.12-0.dotdeb.1 memcache module for php5 Configuration: Place browser_config.xml into the directory /etc/agile (you will likely need to create the directory "agile") Apache2 setup: Nothing special, just be sure to setup ssl. PHP Setup: In order to support file uploads php.ini will have to be modifed. Edit the following values: upload_max_filesize = 1000M post_max_size = 1000M Add the following values: (anywhere is fine, but I put them under the upload section) apc.rfc1867 = on apc.rfc1867_freq = 1K apc.gc_ttl = 259200 apc.max_file_size = 1000M Copy/Move the contents of the package sans the config file to the path you want to host the site from. (typically /var/www/<your_site>) Create a directory named "uploads" under the site root directory ie (/var/www/<your site>/uploads) Change the permissions on the directory to be writeable by www-data:www-data Once apache and PHP configuration is complete remember to restart apache CSS / Branding information: "css/styles.css" can be modified for simple branding changes Replace the logo with your desired header logo. Recommended size 300px x 100px with a transparent background Uncomment / comment out / modify the following styles: .agile-label #upload-help .logo .fileupload-content .ui-progressbar-value For your convenience 3 basic color options have been pre-created: green, blue and gray Troubleshooting: Note: Unless needed for logging / debugging PHP.ini should be set to ignore NOTICE level warnings. Permission issues * Make sure your uploads directory ie /var/www/agile_browser/uploads/ has the proper permissions. user/group www-data should have full read, write and delete permissions. * Agile browser performs some operations (like zipping and deleting local temporary files) which require "safe mode" to be turned off. By default it should be. * Make sure the smarty templates directory has rw permissions by apache (sudo chown -R www-data:www-data /var/www/agile_browser/smart/template*) Upload issues *Agile browser supports uploads of files up to 1gig in size. Your PHP.ini file will need to be updated to support this functionality as well. Command list (intended for reference only) #dep install command list: sudo apt-get update sudo apt-get install zip unzip p7zip p7zip-full sudo apt-get install libapache2-mod-php5 php-apc php-pear sudo apt-get install php5 php5-cli php5-common php5-curl php5-dev php5-gd php5-memcache #fetch / install source code command list: cd ~ wget https://github.com/luke-knol/agile-browser/archive/master.zip unzip master.zip cd agile-browser-master #edit browser_config.xml using the aforementioned instructions sudo mkdir /etc/agile sudo mv ./browser_config.xml /etc/agile sudo mkdir /var/www/browser sudo cp -a -r ./* /var/www/browser sudo mkdir /var/www/browser/uploads sudo chown www-data:www-data /var/www/browser/uploads sudo chown -R www-data:www-data /var/www/browser/smarty/template* #apache setup command list: sudo a2enmod ssl sudo mkdir /etc/apache2/ssl sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt #fill out prompts #edit /etc/apache2/sites-available/default-ssl to reference ssl files just created change site root and directory tag to /var/www/browser (site root) #edit /etc/apache2/sites-available/default DocumentRoot and Document to /var/www/browser (site root) #update /etc/php5/apache2/php.ini with aforementioned config values #enable sites sudo a2ensite default sudo a2ensite default-ssl #restart apache2 sudo /etc/init.d/apache2 restart