Skip to main content


PageSeeder installation and upgrade instructions

Installation of previous versions (5.6 or earlier)

These instructions are ONLY for PageSeeder version 5.6 or earlier. To install any current version, see New installation.

Establish a database for PageSeeder

Connect PageSeeder to a standard relational database. For details, follow the appropriate link below.

Configuring MySQL

Instructions for Microsoft SQL Server 2008 Express (deprecated)

Installation instructions for Oracle (deprecated)

PageSeeder uses only one database user account; however, some databases require a specific license when connecting to web applications such as PageSeeder. If in doubt, consult the vendor.

IMPORTANT: Backup the database and file system!

PageSeeder DOES NOT backup or administer its host database or file system. PageSeeder won’t function when either component is compromised. Take care to perform vendor-recommended backup and maintenance of the PageSeeder database.

For the file system, the critical folders to backup are:

  • pageseeder/documents
  • pageseeder/ps-publisher/WEB-INF/config
  • pageseeder/ps-publisher/WEB-INF/template
  • pageseeder/webapp/WEB-INF/config
  • pageseeder/webapp/WEB-INF/index
  • pageseeder/webapp/WEB-INF/template
  • pageseeder/woconfig

Stopping existing SMTP servers

PageSeeder has its own SMTP server for receiving comments by email. Therefore, before installing PageSeeder, stop and disable any other SMTP servers currently running on the Server.

To do this for the default SMTP server installed with Windows, go to the Services Control Panel. Go down the list of services and select the service called “Simple Mail Transport Protocol (SMTP)”. Press the ‘Stop’ button to stop this service then change the ‘Startup Type’ to Manual.

On Linux, do this by entering:

$ service sendmail stop
$ chkconfig --del sendmail
$ service postfix stop
$ chkconfig --del postfix

Installing the PageSeeder software

Windows Installation

Download and run the pageseeder-x.exe and follow the instructions.

Linux Installation

Running the PageSeeder installer requires CentOS, Fedora or Amazon Linux.

  1. If not installed already install Java 7 or higher (see which version of java)
  2. Download the installer to the Linux server (this includes Apache Tomcat and can install as a Linux service - only includes PageSeeder and is for experienced developers only).
  3. Run the installer, e.g.
    $ chmod +x
    $ ./
  4. Install PageSeeder as a service. When asked for Java location, enter the java 7 or higher directory.
  5. If PageSeeder is NOT installed as a service, it needs to be manually started as follows:
    $ export JAVA_HOME=/usr/java/jdk1.7.0_60
    $ export JAVA_OPTS="-Xmx512m -XX:MaxPermSize=128m -Djava.awt.headless=true"
    $ /usr/pageseeder/tomcat/bin/
  6. Go to the URL for the Setup page in a web browser (e.g. )

Mac OS X Installation

Macs should already include Java. Therefore, run the Unix installer from the Terminal.

If the Mac OS X version is older than Leopard, Snow Leopard or Lion, upgrade the Java version. Follow the instructions provided by Apple.

  1. Download the installer to the Mac (this includes Apache Tomcat, only includes PageSeeder and is for experienced developers only).
  2. Run the installer as root, e.g.
    $ chmod +x $ sudo ./
  3. Follow the instructions to install PageSeeder

    Do not install PageSeeder as a service on Mac!

  4. Manually start PageSeeder, e.g.
    $ /usr/local/pageseeder/tomcat/bin/
  5. Go to the URL for the Setup page in a web browser (e.g. )

Stopping and Starting PageSeeder


Installed as a Service

View the Services under Control Panel, Administrative Tools.

Not installed as a Service

Use the PageSeeder Development Utility under the PageSeeder program group.


Installed as a Service

Enter the following commands:

$ service pageseeder stop
$ service pageseeder start

Alternatively, to stop and then start:

$ service pageseeder restart

Not installed as a Service

Enter the following commands to stop PageSeeder:

$ /usr/pageseeder/tomcat/bin/
$ ps -ef | grep pageseeder

If the PageSeeder Java process is still listed (e.g. root [pid] ... /usr/java ...), then enter the following replacing [pid] by the listed pid number:

$ kill -9 [pid]

Finally start PageSeeder by entering:

$ export JAVA_HOME=/usr/java/jdk1.6.0_30
$ export JAVA_OPTS="-Xmx512m -XX:MaxPermSize=128m -Djava.awt.headless=true"
$ /usr/pageseeder/tomcat/bin/

Mac OS X

To start or stop PageSeeder on a Mac, use the Terminal.

If PageSeeder is installed on /usr/local/pageseeder, use the following command to start PageSeeder:

$ /usr/local/pageseeder/tomcat/bin/

To stop PageSeeder, use:

$ /usr/local/pageseeder/tomcat/bin/

To make it easier, store these command as aliases in the bash profile (in ~/.bash_profile), for example:

alias psstart=/usr/local/pageseeder/tomcat/bin/
alias psstop=/usr/local/pageseeder/tomcat/bin/

Changing the TCP/IP port after installation

  1. Stop the PageSeeder service if it is running and start the pageseeder-x.exe for Windows or the for Linux.
If using the pageseeder-standalone-[version].sh, edit the port manually in the Tomcat or servlet engine configuration and restart it.
  1. Follow the PageSeeder installer prompts and enter the new PageSeeder TCP/IP port.
  2. If there are existing groups/projects, login to PageSeeder as an administrator and go to the Admin > Hosts page. Then, click the “Update Host’s Objects” icon next to each host used to access PageSeeder and click Start to update the schema and port.
Created on , last edited on