From 6b7c849332896f2bc4cd32beb75297e57345a11c Mon Sep 17 00:00:00 2001
From: Linus Rath <139418639+rathlinus@users.noreply.github.com>
Date: Tue, 21 Apr 2026 17:50:18 +0200
Subject: [PATCH] refactor: remove Stalwart API URL configuration

---
 .env.example                | 5 -----
 README.md                   | 1 -
 app/admin/settings/page.tsx | 1 -
 lib/admin/types.ts          | 1 -
 4 files changed, 8 deletions(-)

diff --git a/.env.example b/.env.example
index 99f857fa..1b952ce6 100644
--- a/.env.example
+++ b/.env.example
@@ -27,11 +27,6 @@ JMAP_SERVER_URL=https://your-jmap-server.com
 # Set to "false" to disable if using a non-Stalwart JMAP server.
 # STALWART_FEATURES=true
 
-# If your reverse proxy doesn't forward Stalwart management API paths
-# (/api/account/*, /api/principal/*), set this to the URL where Stalwart's
-# HTTP listener is directly reachable. Defaults to JMAP_SERVER_URL if not set.
-# STALWART_API_URL=https://admin.example.com
-
 # =============================================================================
 # OAuth / OpenID Connect (optional)
 # =============================================================================
diff --git a/README.md b/README.md
index 0feff814..2ded0e07 100644
--- a/README.md
+++ b/README.md
@@ -386,7 +386,6 @@ Enables the admin marketplace for browsing and installing plugins and themes.
 
 ```env
 STALWART_FEATURES=true               # Password change, sieve filters, etc.
-STALWART_API_URL=https://admin.example.com  # If reverse proxy doesn't forward /api/*
 
 LOG_FORMAT=text                      # "text" or "json"
 LOG_LEVEL=info                       # "error", "warn", "info", "debug"
diff --git a/app/admin/settings/page.tsx b/app/admin/settings/page.tsx
index f6aff034..1939c9c1 100644
--- a/app/admin/settings/page.tsx
+++ b/app/admin/settings/page.tsx
@@ -122,7 +122,6 @@ export default function AdminSettingsPage() {
           </div>
         )}
         <ToggleSetting label="Stalwart Features" description="Enable Stalwart Mail Server-specific features" configKey="stalwartFeaturesEnabled" value={currentValue('stalwartFeaturesEnabled') as boolean} source={config.stalwartFeaturesEnabled?.source} onChange={handleChange} onRevert={handleRevert} />
-        <TextSetting label="Stalwart API URL" configKey="stalwartApiUrl" value={currentValue('stalwartApiUrl') as string} source={config.stalwartApiUrl?.source} onChange={handleChange} onRevert={handleRevert} placeholder="https://mail.example.com/api" />
         <ToggleSetting label="Demo Mode" description="Enable demo mode with sample data" configKey="demoMode" value={currentValue('demoMode') as boolean} source={config.demoMode?.source} onChange={handleChange} onRevert={handleRevert} />
       </SettingsSection>
 
diff --git a/lib/admin/types.ts b/lib/admin/types.ts
index 19114661..873a73fc 100644
--- a/lib/admin/types.ts
+++ b/lib/admin/types.ts
@@ -110,7 +110,6 @@ export const CONFIG_ENV_MAP: Record<string, { envVar: string; type: 'string' | '
   appName: { envVar: 'APP_NAME', type: 'string', defaultValue: 'Webmail' },
   jmapServerUrl: { envVar: 'JMAP_SERVER_URL', type: 'url', defaultValue: '' },
   stalwartFeaturesEnabled: { envVar: 'STALWART_FEATURES', type: 'boolean', defaultValue: true },
-  stalwartApiUrl: { envVar: 'STALWART_API_URL', type: 'url', defaultValue: '' },
   demoMode: { envVar: 'DEMO_MODE', type: 'boolean', defaultValue: false },
   devMode: { envVar: 'DEV_MOCK_JMAP', type: 'boolean', defaultValue: false },
   faviconUrl: { envVar: 'FAVICON_URL', type: 'url', defaultValue: '/branding/Bulwark_Favicon.svg' },