---
title: "Installation"
manual: "Laravel-style notification system for TYPO3"
version: "main"
permalink: "https://docs.typo3.org/permalink/agencelex/notifications:installation@main"
source: "Installation/Index.rst"
rendered: "2026-10-29T01:09:24+00:00"
---

> [!TIP]
> Use the table of contents in the left panel to navigate.

# Installation {#installation}

## Requirements {#requirements}

-   TYPO3 CMS **13.4** or **14** or higher
-   PHP **8.2** or higher
-   Composer-based TYPO3 installation (strongly recommended)

The extension requires two additional PHP packages that are pulled in
automatically via Composer:

-   `nesbot/carbon` ^3.2 — human-readable date/time differences
-   `illuminate/collections` ^12.69 — fluent collection helpers

## Installation via Composer (Recommended) {#install-via-composer}

```bash
composer require agencelex/notifications
vendor/bin/typo3 extension:setup
vendor/bin/typo3 upgrade:run
vendor/bin/typo3 cache:flush
```

## Installation via TER (non-Composer) {#install-via-ter}

> [!NOTE]
> Non-Composer installations are supported but not recommended for new
> projects. Ensure the third-party packages listed above are available via
> your autoloader.

1.  Download the extension from the [TYPO3 Extension Repository](https://extensions.typo3.org/extension/lex_notifications).
1.  Upload and install it via **Admin Tools > Extensions**.
1.  Run **Admin Tools > Maintenance > Analyze Database Structure** to
    create the required tables.

## Post-Installation Steps {#post-install}

No configuration needed. Login in the backend, and verify that the module **Notification Messages** is present.

## Database Tables {#database-tables}

The extension creates two tables:

| Table | Purpose |
| --- | --- |
| `tx_lexnotifications_domain_model_notification` | Stores in-app (database-channel) notifications for frontend users. Each row represents one unread or archived notification. |
| `tx_lexnotifications_domain_model_message` | Stores messages composed in the backend module, including recipient lists, delivery channels and send status. |
