---
title: "Pitfalls"
manual: "Mail system"
version: "3.12"
permalink: "https://docs.typo3.org/permalink/mediaessenz/mail:pitfalls@3.12"
source: "QuickStart/Pitfalls.rst"
rendered: "2026-11-03T08:22:20+00:00"
---

# Pitfalls {#pitfalls}

## Wrong Entry Point {#wrong-entry-point}

This extension needs an entry point with a protokoll and domain to proper
fetch internal pages.

An entry point with just a slash ("/") will not work!

This value can be set here "Sites Module" > "Edit site" > "General" > "Entry Point".

If you e.g. use the introduction package, this value is set to "/" by default!

## Self Signed Certificates {#self-signed-certificates}

If you use a self signed certificate, you should also check, that "HTTP" > "verify"
is set to "0".

This can be done under "Admin Tools" > "Settings" > "Configure Installation Wide Options"
\> Filter by "verify" > enter "0" > Press "Write configuration"

The same setting can be done by adding this to the (additional) settings.php:

```php
$GLOBALS['TYPO3_CONF_VARS']['HTTP'][GuzzleHttp\RequestOptions::VERIFY] = false;
```

## Embedding Images & Basic Auth {#embedding-images-with-basic-auth}

If your system is protected by basic auth (e.g. because it's a staging system) you can set
HTTP username and password in the mail wizard settings.

This will add the Guzzle "auth" option to the MailerUtility::fetchContentFromUrl method,
which enables MAIL to fetch the html code for the mail wizard preview.

If you also activate image embedding, the basic auth credentials has to be add at a second
place to enable the MAIL Service, which runs in a different context (CLI), to fetch the images
as well.

To do so, add this to the (additional) settings.php of the **Basic Auth Protected** system (e.g. staging):

```php
$GLOBALS['TYPO3_CONF_VARS']['HTTP'][GuzzleHttp\RequestOptions::AUTH] = ['username', 'password'];
```

## Jumpurl Error Messages {#jumpurl-error-messages}

The current version of jumpurl found in ter (8.0.3) has some php 8 issues:

-   [https://github.com/FriendsOfTYPO3/jumpurl/issues/33](https://github.com/FriendsOfTYPO3/jumpurl/issues/33)
-   [https://github.com/FriendsOfTYPO3/jumpurl/issues/36](https://github.com/FriendsOfTYPO3/jumpurl/issues/36)
-   [https://github.com/FriendsOfTYPO3/jumpurl/issues/37](https://github.com/FriendsOfTYPO3/jumpurl/issues/37)

There is already a pending pull request, which unfortunately stuck in that state
since a while:

-   [https://github.com/FriendsOfTYPO3/jumpurl/pull/35](https://github.com/FriendsOfTYPO3/jumpurl/pull/35)

To help your self out, you could download the zip of the pull request repo, which
contains the necessary fixes under this url:

-   [https://github.com/woodyc79/jumpurl_t3v11/archive/refs/heads/master.zip](https://github.com/woodyc79/jumpurl_t3v11/archive/refs/heads/master.zip)

After downloading, rename the master.zip to jumpurl_8.0.3.zip and upload it within
the extension manager.