Instalation Guide

Index

• Index
• phpmypp Installation
  • Detailed Instructions
    • Distribution/OS Specifics
    • Webserver Specifics
  • Alternative Install Methods
• It Works! What Now?
• It Doesn't Work! Troubleshooting

phpmypp Installation

There are separate upgrade instructions if you have an existing installation.

Try these instructions first. If you still need help, follow one of the links below:

• Step 0: Make sure your server meets the requirements.
• Step 1: Download the newest release from the Download Page.
• Step 2: Read the security page before you begin installing. Take it seriously. If in doubt, ask on the mailing list
• Step 3: Unpack the distribution tarball and upload/copy the files to your webspace.
• Step 4: Open the install.php file in your browser and follow the instructions.(For additional information, see the installer page.)
• Step 5: Enjoy your phpmypp install and browse through the manual to discover what you can do with it.

A screencast of installing phpmypp shows installation to a apache php enabled server, but it may be useful for other situations as well.

Detailed Instructions

If you encounter problems following the steps above or need some detailed information for one of the steps check out these pages:

• Extracting a .tgz archive
• How to set up permissions
• [Installing phpmypp on Hosted Webspace]
• [install.php instructions]
• [Upgrading from a previous Version]
• [Frequently Asked Questions]

Distribution/OS Specifics

• Debian
• Gentoo
• openSUSE
• [Ubuntu]
• [Fedora]
• [Windows]

Webserver Specifics

• [apache]

Alternative Install Methods

• [phpmypp Downloader] - a single script that takes care of downloading and installing
• [phpmypp on a Stick] - run phpmypp directly from an USB stick
• [Using Git] to handle the installation

It Works! What Now?

Here is what you may want to do when everything is up and working:

• [Check the security page] again
• [Consider enabling URL rewriting]
• [Choose a license] for your content—use config license or edit the footer.html inside the phpmypp/lib/tpl/… folder if your template doesn't use tpl_licence()
• [Enter a few words] how and where you use phpmypp in the userpage
• [Subscribe to the newsletter]
  • Read:
    • [Frequently Asked Questions]
    • [day-to-day maintenance needed for phpmypp]
    • [tips and tricks], especially best-practices to follow after installing

It Doesn't Work! Troubleshooting

If you've encountered problems installing phpmypp, and you've carefully checked each of the steps above:

• Download the source package again to ensure you do not have a corrupt download
• Upload your files again—FTP corruption is a common cause for problems. Uploading a zip file and extracting on the server may be more reliable than uploading files individually

• Double and triple check file and folder permissions—this is a very common cause of problems

• Be sure to search the forum before posting your questions to the installation forum