---
title: "New installation"
source: https://dev.pageseeder.com/guide/installation/new_installation.html
description: "This document provides prerequisites and initial setup guidance for installing PageSeeder, including database configuration requirements, critical backup procedures, port usage information, and operating system-specific installation options."
last_updated: 2026-08-11T16:10:50+10:00
tokens: ~588
---

# New installation

For information regarding supported operating systems and hardware requirements, see [Installing PageSeeder](../installation.md).

## Before beginning!

PageSeeder requires a MySQL or PostgreSQL relational database to function. To minimize the chance of installation-related problems, closely read the following instructions.

### First, consider the database

For a problem-free installation, ensure the ability to communicate with MySQL or PostgreSQL **before** commencing the install. Don’t wait for prompting from the install. By that point, ‘problem-free’ is no longer an option!

See [Configuring MySQL](mysql.md) or [Configuring PostgreSQL](configuring_postgresql.md).

#### **IMPORTANT**: database and file system backup!

> **Warning:** PageSeeder **DOES NOT** backup or administer the host database or file system. If the integrity of either component is compromised, the application won’t function. To minimize the potential for problems, users should follow all recommended backup and maintenance procedures.

In accordance with good administration practices, system owners should consider encrypting all backups and routinely test that restore procedures provide the expected results.

#### File system

Once in production, the critical folders to backup from the host operating system are:

```text
pageseeder/documents
pageseeder/WEB-INF/config
pageseeder/WEB-INF/state
```

### Second, check what ports your server is using

By default PageSeeder uses the following TCP/IP ports:

- 25: Incoming mail SMTP
- 443: Secure HTTP
- 2525: Incoming mail SMTP (internal)
- 8005: Shutdown command (internal)
- 8282: Non-secure HTTP

If any of these ports are used by other services on the computer where PageSeeder will be installed then those services must be disabled.

> **Note:** The PageSeeder SMTP server is for incoming email only. For PageSeeder to send email, another SMTP server on a different computer is required.

## Begin installing PageSeeder

Choose the operating system that PageSeeder will be installed on:

- [New installation on Windows](new_installation/new_installation_on_windows.md)
- [New installation on el7](new_installation/new_installation_on_el7.md) for example RHEL v7 or CentOS v7.
- [New installation on el8/el9](new_installation/new_installation_on_el8_el9.md) for example Rocky v8 or v9.