Please rate how useful you found this document: 
Average: 2.2 (5 votes)

Warning: MacOSX Installation in ProcessMaker has been included under an experimental section, since this installation has not being tested by QA Department yet, so this is not officially supported by ProcessMaker.

General Information

Tested over Mac OSX Lion 10.6


Web stack XAMPP, you can download this from  this page.

Installing MacOSX

Download XAMPP and install it using the configuration by default; then, move XAMPP folder to Applications folder, the installer will help with moving it.

With Finder application enter into folder Applications > XAMPP and execute application XAMPP Control in order to arrange Apache and MySQL.

to test it copy this url: http://localhost in you browser.

Download ProcessMaker and unpack in the folder


Setting file permissions

Then, issue the following commands as the "root" user so that ProcessMaker can access the necessary files when run by the Apache server:

cd /Applications/XAMPP/htdocs/processmaker/
chmod -R 770 shared/
cd /Applications/XAMPP/htdocs/processmaker/workflow/engine/
chmod -R 770 /Applications/XAMPP/htdocs/processmaker/workflow/public_html
chmod -R 770 config content/languages plugins xmlform js/labels
chown –R <apache_user>:<apache_group> /Applications/XAMPP/htdocs/processmaker

you can verify or change the Apache user and group at


Configuring apache

Edit the xampp virtual hosts configuration, httpd-vhosts.conf file located at


Edit as follows:

ServerAdmin webmaster@localhost
DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs"
ServerName localhost
ServerAlias localhost
ErrorLog "logs/localhost-error_log"
CustomLog "logs/localhost-access_log" common
#processmaker virtual host  
  ServerName "*"    
  DocumentRoot /Applications/XAMPP/htdocs/processmaker/workflow/public_html    
  DirectoryIndex index.html index.php    
    AddDefaultCharset UTF-8        
    AllowOverRide none        
    Options FollowSymlinks        
    Order allow,deny        
    Allow from all        
    RewriteEngine on        
    RewriteRule ^.*/(.*)$ sysGeneric.php [NC,L]        
    ExpiresActive On        
    ExpiresDefault "access plus 1 day"        
    ExpiresByType image/gif "access plus 1 day"        
    ExpiresByType image/png "access plus 1 day"        
    ExpiresByType image/jpg "access plus 1 day"        
    ExpiresByType text/css "access plus 1 day"        
    ExpiresByType text/javascript "access plus 1 day"        
    AddOutputFilterByType DEFLATE text/html    

Add the port number on httpd.conf file located at:


Add Line:

Listen 8080

Now include the virtual hosts created in the httpd-vhosts.conf file. Go to:


Delete the Hash(pound) # from the line:

#Include /Applications/XAMPP/etc/extra/httpd-vhosts.conf

And leave as follows:

# Virtual Hosts
Include /Applications/XAMPP/etc/extra/httpd-vhosts.conf

Known Issues

If you experiment some problems like 404 error, it is generally related to permissions. Check the folders permissions and try again.