Leafpub is easy to install. This brief guide will show you how.


  1. Download the latest version of Leafpub and unzip it.
  2. Upload the resulting files to your server. You can upload them to the website root or to a subfolder if you like.
  3. Point your browser to your server (e.g. http://your-domain.com/).
  4. The installer will appear.



The Owner Account

Start by entering your name and email address, then pick a username and create a password for the owner account.

Remember these! You'll need them to login later on.

Connect to the Database

The next step is to connect to your database. Leafpub supports MySQL and MariaDB starting at version 5.5.3.

  1. Enter your database host. This is usually localhost, but if your database is hosted on a separate server enter it here.
  2. Enter the database user and password. If you don't have one, you may need to create one first. Check your hosting provider's documentation for details on how to do this.
  3. Enter the database name.
  4. If you're sharing a database with another app, set a custom table prefix to distinguish Leafpub's tables from other apps. The default is leafpub_.
  5. Click Install.

If your database settings are correct, Leafpub will initialize the database, log you in, and send you over to the admin panel.

Apache Users

If you're installing Leafpub on an Apache server, make sure it honors .htaccess files. Alternatively, you can use the settings in source/defaults/default.htaccess as a starting point to configure your server manually.


If you need to update to a newer version of Laefpub, follow these steps:

  1. Download the latest version from leafpub.org/download.
  2. Unzip the file.
  3. On your server, replace index.php and source/ with the new version.

This is how you can manual update until the automatic updater is available.


If your installation doesn't go smoothly, you should see a helpful error message. Leafpub is still quite new, however, so if something doesn't work right, please refer to the support page for help.