Published: Jul 7, 2010. Updated: Jan 1, 2013.
Onpub can be installed on any operating sytem that meets the minimum System Requirements.
If your system is missing any of the requirements, please install them before you continue with the Onpub installation. Provided your system meets the minimum version requirements for both PHP and MySQL, Onpub should work with the default installation settings for both MySQL and PHP.
Make sure you've downloaded the latest version of Onpub. The most recent version can always be found on the home page.
Once on the page, click Download Onpub and save the resulting ZIP file to your hard drive. Once the download completes, extract the Onpub ZIP file to the root of your web server's public HTML directory. For example, this directory is located by default at C:\inetpub\wwwroot on Windows/IIS, /var/www/html if you use Red Hat Linux, or /var/www if you use Ubuntu Linux. Consult your web server or web hosting documentation if you are unsure of where to place PHP and other website files on your system.
Once you've unzipped the Onpub download to your web server's public HTML directory, you can move on to the next step to setup a MySQL database for use with Onpub.
Unzipping the Onpub download ZIP file results in the following file/directory hierarchy:
Onpub requires a MySQL database to store the websites you will be creating. In order to setup a MySQL database for use with Onpub, do the following:
Provided the above two MySQL commands were successful, you should now have a MySQL database and account we will be using to complete the Onpub installation.
If your MySQL server is installed on the same host as your web server, you can skip this section.
By default, Onpub attempts to connect to a MySQL server running on localhost (127.0.0.1) when you login to the content management interface.
If your MySQL server runs remotely, then perform the steps below to configure Onpub to talk to the remote database server.
To change the hostname/IP address of Onpub's default database host, follow the steps below:
Alternatively, you can comment out the whole line so that it looks like:
The above will cause the Onpub login screen to show a Hostname field, which allows you to specify your MySQL server's hostname prior to your login attempt.
Load the following URL in your web browser to login:
Replace localhost in the above URL with your web server's hostname if you are not running Onpub locally.
The login screen has 2 input fields called Username and Password. Here's what should be entered in to each field in order to login:
Type in the name of the MySQL user account that has access to the database created in the section above.
Type in the the MySQL account password for the user name entered in to the field above.
Once you've entered the correct login info, click the Login button and you will be able to connect to any of the databases that your MySQL account has access to.
When you connect to a MySQL database with Onpub for the first time, be sure to click the Install the Onpub database schema link on the Dashboard page to install the Onpub tables in to the connected MySQL database. You will not be able to publish a website with Onpub until you perform this step.
With the database schema installed, you are now ready to Publish an Onpub website.