---
title: "Feature: #99221 - Introduce CLI setup command"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-97747-1669740094"
source: "Changelog/12.1/Feature-99221-AddCliInstallSetupCommand.rst"
typo3-version: "12.1"
typo3-major: 12
type: "feature"
issue: 97747
forge: "https://forge.typo3.org/issues/97747"
tags: ["ext:install"]
rendered: "2026-09-17T21:17:42+00:00"
---

# Feature: #99221 - Introduce CLI setup command {#feature-99221-introduce-cli-setup-command}

See [forge#99221](https://forge.typo3.org/issues/99221)

## Description {#description}

To be able to automate the setup process for new TYPO3 installations,
a new CLI command `setup` is introduced as an alternative to the existing
GUI based web installer.

## Impact {#impact}

You can now use `./bin/typo3 setup` to set up your TYPO3 installation without
needing to run through the web installer.

### Example {#example}

Interactive / guided setup (questions/answers):

```bash
./bin/typo3 setup
```

Automated setup:

```bash
TYPO3_DB_DRIVER=mysqli \
TYPO3_DB_USERNAME=db \
TYPO3_DB_PORT=3306 \
TYPO3_DB_HOST=db \
TYPO3_DB_DBNAME=db \
TYPO3_SETUP_ADMIN_EMAIL=admin@example.com \
TYPO3_SETUP_ADMIN_USERNAME=admin \
TYPO3_SETUP_CREATE_SITE="https://your-typo3-site.com/" \
TYPO3_PROJECT_NAME="Automated Setup" \
TYPO3_SERVER_TYPE="apache" \
./bin/typo3 setup --force
```

> [!WARNING]
> Variable `TYPO3_DB_PASSWORD` (option `--password`) can be used to provide a
> password for the database and `TYPO3_SETUP_ADMIN_PASSWORD`
> (option `--admin-user-password`) for the admin user password.
> Using this can be a security risk since the password may end up in shell
> history files. Prefer the interactive mode. Additionally, writing a command
> to shell history can be suppressed by prefixing the command with a space
> when using `bash` or `zsh`.