petiole Documentation                                                                      

Docs and Installation

  1. petiole Docs
  2. petiole SDKs
  3. petiole CMS Plugins
  4. petiole ReadTheDocs
  5. petiole API Docs
  6. Installation on cPanel / shared hosting (below)
  7. Installation on Ubuntu 14 (below)
  8. Installation CentOS 7 (below)


Install petiole on cPanel or shared hosting account.

  1. Download
  2. Extract to your desktop
  3. Edit /includes/mail.config.php, replacing email with your own cPanel email
  4. Upload all of the files to the directory you want to install in.
  5. Create 2 postgresql databases: user_petiole and user_petiole_stats, where ‘user’ is your cPanel user name (the databases can be names whatever you like, we are using user_petiole just for example).
  6. Open a browser and navigate to the directory you installed petiole in.
  7. Follow the installation screens as below.


Install petiole on Ubuntu 14.x VPS

The following is only for use on a clean installation.

Get the installer from our secure CDN:

[root@server ~]# wget

Check the file integrity:

[root@server ~]# md5sum

MD5 output should match

Make the file executable:

[root@server ~]# chmod 755

Run the installer!

[root@server ~]# ./


The script takes a few minutes, be patient. You will be prompted for SMTP credentials (required) as well as domain/VHOST (optional). If you do not have access to an email account see email section below.

A the end of installation your mapfig user password, database name, database password, and postgres password will be displayed as below as well as saved to an auth file (/root/mapfig-install.auth) on the file system.

Virtual Host Configuration: /etc/apache2/sites-enabled/000-default.conf
Your studio database name is: fjcfgldypqimux
Your studio stats database name is: fjcfgldypqimux_stats
Your studio postgresql user password is: ClXpkibHXD68gYDAGKjn--M79C2bbFFd
Your studio os user password is: -cfWQ8pHXfWMGUzUTU_J-yLd2Qi3dq2F
Your postgres superuser password is: 6nAnKT9QQn8fR_0e508WYgFuaI0UzmhX
Password are saved in /root/studio-install.auth

Navigate to your VM IP and follow the installation screens:

Below, populate the fields with values from studio-install.auth that are displayed at end of script:


Select Admin User Name, Password, and Email:


If verifcation email does not work, follow the steps below to re-run mail configuration. You can re-run this as many times as you wish to set/change/update mail settings.

[root@server ~]# wget
[root@server ~]# chmod 755
[root@server ~]# ./



If you want to point a sub domain (e.g. and did not do so during the install, follow steps below to re-run vhost configuration. You can re-run this as many times as you wish to set/change/update mail settings.

[root@server ~]# wget
[root@server ~]# chmod 755
[root@server ~]# ./

Bypass Email Requirements

If you do not wish to use email functionality, or do not have access to an SMTP server, connect as user mapfig to the postgresql database that was created by the script (fjcfgldypqimux, in our example above) :

root@mapfig:/opt# su - mapfig
$ psql -d fjcfgldypqimux -U mapfig
Password for user mapfig:
psql (9.4.4)
Type "help" for help.


Run the update statement below, where ‘’ is the email you used during installation:

fjcfgldypqimux=> update users set activationkey = '' where email = '';

Install petiole on RHEL/CentOS VPS

Script Installers

The following is only for use on a clean installation.

The procedure is indentical to the Ubuntu scipt installer above, the only difference is the file name and url:

[root@server1 ~]# wget
[root@server1 ~]# md5sum

MD5 output hould match

[root@server1 ~]# chmod 755
[root@server1 ~]# ./

From here, you can use the Ubuntu instructions above.

For the mail script, the file is identical:

[root@server1 ~]# wget

For the VHOST script, the file is

[root@server1 ~]# wget


Manual Installation

System Requirements

  • Any Linux OS x64
  • PHP 5.x
  • PostgreSQL 9.x
  • SuPHP or mod_ruid2
  • Postfix
  • GDAL>=1.8
  • Apache HTTP Server
  • Accessing to a working SMTP email account. While you can configure this on the box you install petiole, the application is designed to authenticate email and links via an smtp email service. If you do not want email verification functionality or do not have access to an SMTP email account, see “Bypass Email Requirements” below.
  • The above components have been tested, lower or other versions may work.