---
title: "Installation"
manual: "TYPO3 Analytics"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3g/analytics:installation@main"
source: "Installation/Index.rst"
rendered: "2026-09-21T10:47:42+00:00"
---

# Installation {#installation}

## Install via Composer {#install-via-composer}

```bash
composer require t3g/analytics
```

Activate the extension in the TYPO3 Extension Manager or via the CLI:

```bash
vendor/bin/typo3 extension:setup analytics
```

## Install via TER (Classic mode) {#install-via-ter-classic-mode}

In a non-Composer TYPO3 installation, search for **analytics** in
**Admin Tools → Extensions** and install it from there, or download it
directly from the [TYPO3 Extension Repository](https://extensions.typo3.org/extension/analytics). Make sure the
**Dashboard** system extension is active before installing, as the extension
depends on it.

## Deployment note {#deployment-note}

Site-specific data written by the extension (credentials, tracking code, API
keys) is stored in each site's `config/sites/<identifier>/settings.yaml`.
This file is separate from the structural `config.yaml` and contains
sensitive values that must not be committed to the repository. In a
deployment setup, `settings.yaml` should be kept in a shared folder
outside the release directory and symlinked or copied on each deploy.