Skip to main content


PageSeeder installation and upgrade instructions

Upgrading (to version 5.6 or earlier)

Before installing any upgrade, make a backup of the PageSeeder install folder and the PageSeeder database. To preserve the PageSeeder cache, the PageSeeder service needs to be stopped before doing the backup.

Before upgrading, read the NOTE sections in any release notes after the current version to ensure the project customizations are compatible with the new version.


To upgrade to version 5.6 or earlier, follow these steps:

  1. Stop the PageSeeder windows service.
  2. Double click on the new pageseeder-x.exe installer.


To upgrade to version 5.6 or earlier, follow these steps:

  1. If Java 8 or higher is not installed (see which version of java), choose one of the following options:
    • OpenJDK (JDK 8) install 
      $ su -c "yum install java-1.8.0-openjdk"


    • Oracle (e.g. download Server JRE 64-bit) Java Linux install 

      $ cd /usr/java
      $ tar zxvf server-jre-8u<version>-linux-x64.tar.gz
      $ rm server-jre-8u<version>-linux-x64.tar.gz
      $ cd /usr/bin
      $ mv java java.bak
      $ ln -s /usr/java/jdk1.8.0_<version>/bin/java 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. If upgrading from version 4.x, stop and disable your existing PageSeeder as shown following.

    As of version 5, start/stop PageSeeder using service pageseeder start/stop, NOT service tomcat start/stop.

    $ service tomcat stop
    $ chkconfig --del tomcat
    $ rm /etc/init.d/tomcat
  4. Run the installer, e.g.
    $ chmod +x
    $ ./
  5. Follow the instructions to upgrade PageSeeder (it is recommended to install as a service). When asked for Java location, enter your java 8 or higher directory.
  6. If you did NOT install as a service, manually start PageSeeder as follows:
    $ export JAVA_HOME=/usr/java/jdk1.8.0_60
    $ export JAVA_OPTS="-Xmx512m -XX:MaxPermSize=128m -Djava.awt.headless=true"
    $ /usr/pageseeder/tomcat/bin/
  7. Go to the URL for the Update page in a web browser (e.g. ) and update the database if required.
Created on , last edited on