Title: Onion Service by Adam Szokol
Author: Adam Szokol
Published: <strong>2. November 2025</strong>
Last modified: 22. Dezember 2025

---

Plugins suchen

![](https://ps.w.org/adamszokol-onion-service/assets/icon-256x256.png?rev=3388451)

# Onion Service by Adam Szokol

 Von [Adam Szokol](https://profiles.wordpress.org/szokoladam/)

[Herunterladen](https://downloads.wordpress.org/plugin/adamszokol-onion-service.1.0.2.zip)

 * [Details](https://de.wordpress.org/plugins/adamszokol-onion-service/#description)
 * [Rezensionen](https://de.wordpress.org/plugins/adamszokol-onion-service/#reviews)
 *  [Installation](https://de.wordpress.org/plugins/adamszokol-onion-service/#installation)
 * [Entwicklung](https://de.wordpress.org/plugins/adamszokol-onion-service/#developers)

 [Support](https://wordpress.org/support/plugin/adamszokol-onion-service/)

## Beschreibung

The Onion Service by Adam Szokol plugin provides reliable functionality for integrating
your WordPress site with the Tor network. It configures your site to handle .onion
addresses, which can enhance accessibility and privacy for your visitors using the
Tor Browser. This plugin is built to work effectively on both single-site and WordPress
Multisite installations.

A core feature is its administrative helper functionality. On activation, the plugin
checks for and creates a necessary sunrise.php file for domain mapping support. 
It also attempts to add the required define( ‚SUNRISE‘, true ); constant to your
wp-config.php file, which is often the most complex step in the setup process. This
modification is only attempted if file permissions allow it.

The settings interface is available only to administrators (or Super Admins on Multisite),
allowing you to easily map your .onion domains and manage the service status.

Key Features:

Automatic sunrise.php Creation: Handles the creation and placement of sunrise.php
for reliable domain mapping.

Optional wp-config.php Modification: Attempts to safely add the SUNRISE constant
to your configuration file, providing a setup assist.

Unified Architecture: Works consistently across single WordPress sites and Multisite
networks.

Onion-Location Header: Automatically informs Tor Browser users that a private .onion
version of your site is available.

Full Domain Mapping: Assign unique .onion domains to specific sites in your installation.

Service Status Control: Easily disable the onion service and display a custom maintenance
message.

## Installation

Upload the adamszokol-onion-service folder (or the single adamszokol-onion-service.
php file) to the /wp-content/plugins/ directory.

Activate the plugin through the ‚Plugins‘ menu in WordPress.

On activation, the plugin will attempt to create /wp-content/sunrise.php and add
define( ‚SUNRISE‘, true ); to your wp-config.php file.

Go to Settings -> Onion Service (or My Sites -> Network Admin -> Onion Service on
Multisite).

If you see any warnings at the top of the settings page, follow the instructions.
This usually involves setting file permissions or manually adding a line to wp-config.
php if the automatic process failed.

Use the settings page to map your .onion address to your site.

For a standard site, the Site ID is 1.

On Multisite, search for the site you want to map.

Click „Save Settings & Mappings“.

## FAQ

### Why is sunrise.php needed?

Using sunrise.php for all installations creates a common, robust architecture. It
is the most reliable way to intercept a request for an .onion domain before WordPress
determines the primary site URL, which helps prevent redirect loops and ensures 
proper site loading. This plugin automates the initial setup.

### The plugin said it couldn’t modify my wp-config.php file. What do I do?

For security reasons, your wp-config.php file may not be writable by the server.
This is normal. Simply open the file and manually add this line before the line 
that says /* That’s all, stop editing! Happy publishing. */:

define( ‚SUNRISE‘, true );

### Is it safe to let a plugin modify wp-config.php?

This plugin is designed to be careful. It uses the WordPress Filesystem API and 
only attempts to write to the file if the SUNRISE constant is confirmed to be missing.
If your server permissions don’t allow the write, the plugin will fail safely and
instruct you to perform the action manually.

## Rezensionen

Zu diesem Plugin liegen noch keine Rezensionen vor.

## Mitwirkende und Entwickler

„Onion Service by Adam Szokol“ ist Open-Source-Software. Folgende Menschen haben
an diesem Plugin mitgewirkt:

Mitwirkende

 *   [ Adam Szokol ](https://profiles.wordpress.org/szokoladam/)

[Übersetze „Onion Service by Adam Szokol“ in deine Sprache.](https://translate.wordpress.org/projects/wp-plugins/adamszokol-onion-service)

### Interessiert an der Entwicklung?

[Durchstöbere den Code](https://plugins.trac.wordpress.org/browser/adamszokol-onion-service/),
sieh dir das [SVN-Repository](https://plugins.svn.wordpress.org/adamszokol-onion-service/)
an oder abonniere das [Entwicklungsprotokoll](https://plugins.trac.wordpress.org/log/adamszokol-onion-service/)
per [RSS](https://plugins.trac.wordpress.org/log/adamszokol-onion-service/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **1.0.2**
 *  Zuletzt aktualisiert **vor 10 Monaten**
 *  Aktive Installationen **weniger als 10**
 *  WordPress-Version ** 5.8 oder höher **
 *  Getestet bis **6.9.10**
 *  PHP-Version ** 7.4 oder höher **
 *  Sprache
 * [English (US)](https://wordpress.org/plugins/adamszokol-onion-service/)
 * Schlagwörter
 * [multisite](https://de.wordpress.org/plugins/tags/multisite/)[onion](https://de.wordpress.org/plugins/tags/onion/)
   [privacy](https://de.wordpress.org/plugins/tags/privacy/)[security](https://de.wordpress.org/plugins/tags/security/)
   [Tor](https://de.wordpress.org/plugins/tags/tor/)
 *  [Erweiterte Ansicht](https://de.wordpress.org/plugins/adamszokol-onion-service/advanced/)

## Bewertungen

Es wurden noch keine Rezensionen eingereicht.

[Deine Rezension](https://wordpress.org/support/plugin/adamszokol-onion-service/reviews/#new-post)

[Alle Rezensionen anzeigen](https://wordpress.org/support/plugin/adamszokol-onion-service/reviews/)

## Mitwirkende

 *   [ Adam Szokol ](https://profiles.wordpress.org/szokoladam/)

## Support

Möchtest du etwas mitteilen? Brauchst du Unterstützung?

 [Support-Forum anzeigen](https://wordpress.org/support/plugin/adamszokol-onion-service/)