Developers' Forum

A full REST API for ISPConfig (OpenAPI, all modules) — looking for testers

invalid@example.com (tio289) — Tue, 07 Jul 2026 12:51:20 +0000

This request comes up a lot, so I wanted to share a project I've built to actually solve it.

As many have pointed out, the official "REST" endpoints are really just a thin wrapper around the old SOAP remote API - limited coverage, no OpenAPI/Swagger spec, and a lot of features simply aren't exposed. I wanted something that treats a real REST API as the goal, not an afterthought.

So I built ispconfig-rest: a modern, contract-first REST API for ISPConfig 3.3, on Laravel 12.

~270...

A full REST API for ISPConfig (OpenAPI, all modules) — looking for testers

ISPConfig REST-API Standard

invalid@example.com (Aeon112) — Mon, 06 Jul 2026 21:30:51 +0000

Hey there!
are there any Plans in the Future to make ISPConfig fully REST Compatible with the OpenAPI Standard? I think it's much easier to handle and Programm than the SOAP API, especially for connections to other languages like GO, Ruby, Python... I can try to Implement an REST API for ISPConfig if this is desired? OpenAPI is the defect Standard for REST and Swagger.io. What are your opinions about rest?

ISPConfig REST API

invalid@example.com (Aeon112) — Mon, 06 Jul 2026 21:30:17 +0000

Hey,
are the Docs in the Folder Remoting-Client also for the Json API or where can I get a detailed Docs for the Json/REST API? I wan't to create a Composer project for the ISPConfig API to include it in Laravel or Symfony Applications, but I don't find any Howtos or tutorials for the ISPConfi REST API. Thanks!

Greets

False WARNING "PHP cli binary is not available in the jail" when PHP is present via global jailkit_c

invalid@example.com (RalphGL) — Tue, 16 Jun 2026 11:06:53 +0000

Hi,
I'd like to report a bug I found in ISPConfig's Jailkit handling. I searched the forum but couldn't find an existing report for this specific scenario.

Environment:

Debian 13
ISPConfig 3.3.1p1 (latest stable)
Apache + PHP-FPM
PHP 8.4 / 8.5

Problem:
When a website has PHP disabled (php = no) or no explicit PHP version assigned (server_php_id = 0), but an SSH/SFTP jail user is configured, ISPConfig sends a false warning email:

WARNING - The PHP...

False WARNING "PHP cli binary is not available in the jail" when PHP is present via global jailkit_c

NGINX Redirect Config bug in ISPConfig 3.3.1p1

invalid@example.com (Bay Internet) — Thu, 28 May 2026 06:45:38 +0000

When creating a Redirect, of Type Redirect in the control Panel, which is essentially a 302 redirect, the generated NGINX config file has a syntax error.

The correct syntax is:
rewrite ^(?!/(\.well-known/acme-challenge))/(.*)$ http://example.com/$2 redirect;

However ISPconfig creates the directive without a "/" at the end of the domain name, like:
rewrite ^(?!/(\.well-known/acme-challenge))/(.*)$ http://example.com$2 redirect;

This results in example.com/test.html...

NGINX Redirect Config bug in ISPConfig 3.3.1p1

Fully automated SSL setup for mail.* and webmail.* domains

invalid@example.com (ezflashback) — Thu, 19 Mar 2026 10:24:33 +0000

Automated Global SSL for Mail & Webmail on ISPConfig 3

This guide provides a robust, automated solution for ISPConfig 3 environments to manage a Global SSL Certificate (Multi-Domain/SAN) covering mail.domain.tld and webmail.domain.tld for all hosted clients. This version includes a filter to ignore multi-level subdomains and performs a database cleanup to prevent duplicate entries.

1. Prerequisites

ISPConfig 3.x installed on...

Fully automated SSL setup for mail.* and webmail.* domains

Feature Request: Integrated Mail SNI support for Postfix and Dovecot

invalid@example.com (ezflashback) — Tue, 17 Mar 2026 12:28:25 +0000

Hi ISPConfig team and community,
First of all, thanks for the amazing work on ISPConfig! It’s a fantastic control panel and makes server management so much easier.

I recently spent some time fixing a common issue and thought it would be a great addition to the core features: Automatic Mail SNI (Server Name Indication) for Postfix and Dovecot.

The Problem:
In multi-domain setups, mail clients (like Thunderbird or Outlook) often throw "Certificate Mismatch" warnings when users try to use...

Feature Request: Integrated Mail SNI support for Postfix and Dovecot

Reorganizing ISPConfig and HowtoForge

invalid@example.com (till) — Fri, 06 Feb 2026 14:37:34 +0000

Hi Guys,

I've started with planning for a reorganization of the ISPConfig project and HowtoForge, and I would like to hear your opinions on a few topics.

First, what to do with the forum? Options are:

a) Just update it and give it a new theme.
b) Switch from XenForo to another, more modern system. E.g. Discourse. Such a switch might cause some information loss as not everything can be transferred 1:1.

Plus, I'm considering putting the forum on an ISPConfig subdomain as it's mainly an...

Reorganizing ISPConfig and HowtoForge

PHPMyAdmin Link Bug

invalid@example.com (rwestebbe) — Tue, 03 Feb 2026 14:22:18 +0000

Hello,

I couldn't find a dedicated forum for bug reports, so I'm posting the bug here.

After the last update, the button for PHPMyAdmin was no longer displayed in ISPConfig. The reason for this was that the following query was in

/usr/local/ispconfig/interface/web/sites/database_list.php

in the function prepareDataRow($rec) contained the following query:

if($db_type == ‘mysql’ && $this->global_config[‘dblist_phpmyadmin_link’] == ‘y’)

but the variable $db_type contained “MySQL.”...

PHPMyAdmin Link Bug

ISPConfig Roadmap for 2025

invalid@example.com (till) — Fri, 30 Jan 2026 16:23:49 +0000

ISPConfig Roadmap for 2025: Exciting New Features, Official AlmaLinux & Rocky Linux Support, and More.
Read the full article: https://www.ispconfig.org/blog/ispc...icial-almalinux-rocky-linux-support-and-more/

Test ispconfig 3.3.1.b1 on Rocky Linux 10.1

invalid@example.com (DarioL) — Tue, 27 Jan 2026 18:59:55 +0000

I have install a minimal new Rocky Linux 10.1 system and try to setup on it the new beta release.
I have follow the "The Perfect Server CentOS 8" guide with some adjustments (If you're interested I can show you how I did it) and install all functionality except some functions not usually used by me, such as mod_python, metronome, mailman
The "php -q install.php" is gone without problem.
The first problem is happened when I try to access to ISPC panel: blank panel.
This is what I get from...

Test ispconfig 3.3.1.b1 on Rocky Linux 10.1

Display and sorting in the website backups table

invalid@example.com (Pyanepsion) — Thu, 15 Jan 2026 07:26:29 +0000

Sites → Website → Backup
The backups table shows several user-interface issues, independent of the language used.

View attachment 9465

1. ‘Backup file’ column
File names are long (especially for database backups).
When the text exceeds the available width, it is not truncated: it overflows into the other columns and breaks the table layout.
I therefore think of a combination:

Code:

text-overflow: ellipsis; white-space: nwrap; overflow: hidden;

2. Column widths not...

Display and sorting in the website backups table

Missing string for the ‘no PHP options selected’ error

invalid@example.com (Pyanepsion) — Sat, 10 Jan 2026 22:45:13 +0000

Version
ISPConfig 3.3.x (Debian 12, Nginx + PHP-FPM stack)
Module
System → System Config → Sites
Context
Nginx server (no Apache)
View attachment 9458
1. Wrong label for the PHP handler field
The field is displayed as:

Code:

PHP Handler (Apache only)

Current key:

Code:

$wb['web_php_options_txt'] = 'PHP Handler (Apache only)';

This label is wrong on a Nginx system, because:
– PHP-FPM is used under Nginx;
– this setting actually controls the PHP runtime behaviour;
–...

Missing string for the ‘no PHP options selected’ error

Website harddisk quota with unlimited setting and negative usage percentages

invalid@example.com (Pyanepsion) — Sun, 04 Jan 2026 10:20:33 +0000

Observation
When the disk quota is set to unlimited, calculations treat the sentinel value (-1) as a real numeric value, which leads to display anomalies, in particular negative percentages.
However, an unlimited quota does not remove the notion of a limit; it only removes the per-site limit. The relevant limit then becomes the actual capacity of the storage volume.
The usage percentage should, therefore, be calculated against this capacity in order to provide information that is correct,...

Website harddisk quota with unlimited setting and negative usage percentages

Display issue in the Databases/Database Users section

invalid@example.com (Pyanepsion) — Sat, 03 Jan 2026 11:16:02 +0000

Four anomalies are observed in the validation of the Databases and Database Users forms. They concern only the display of error messages or the translation strings.

Coding issue

Duplicate message (database name)
The key database_name_error_empty (Database name is empty) is displayed twice when creating a database.

View attachment 9454
Explanation issues (strings / announced limits)

Incorrect announced maximum length for database names
The...

Display issue in the Databases/Database Users section

Request to change internal variable names in language files

invalid@example.com (Pyanepsion) — Fri, 02 Jan 2026 07:30:20 +0000

Description
In the “Alias domain for website” form, the labels of the first two fields are generated using incorrect language keys.
This is not a functional issue, but a UI / language-key mapping bug that results in misleading field labels.

Issue 1 — First field (input field)
The first field (used to enter the alias name) does not use the expected language key host_txt.
Instead, it uses the language key of the second field (domain_txt).

Expected:...

Request to change internal variable names in language files

UTF-8 support in X.509 certificates (SSL tab)

invalid@example.com (Pyanepsion) — Wed, 31 Dec 2025 13:55:11 +0000

Hello,

Accented letters are indispensable in many languages other than English.
In practice, this prevents some users from entering correctly spelled identity information, for example a French region name, a Luxembourg locality, or an Italian organization name.

It is worth recalling that the X.509 standard, as defined in RFC 5280, section 4.1.2.4 (DirectoryString), explicitly provides for the use of UTF8String, allowing Unicode characters to be used in certificate identity fields...

UTF-8 support in X.509 certificates (SSL tab)

ISPConfig 3.3.1 Beta 1 Released – Debian 13 Support in ISPConfig

invalid@example.com (till) — Fri, 26 Dec 2025 19:02:51 +0000

2FA by email available for admin CP users without email address

invalid@example.com (Pyanepsion) — Thu, 25 Dec 2025 08:05:37 +0000

In System → CP Users, the option ‘Two-factor authentication: email’ is available when creating an new admin user, although this type of account has no client record and no email address can be defined in this form.
There is no field to specify or verify which email address would be used for this authentication method.
In this context, the behaviour of this option is not clear.
Is this the intended behaviour?
If not, possible approaches could be:
—hiding this option for admin...

2FA by email available for admin CP users without email address

data_processing_error email_error_isemail, login_error_regex, quota_error_value

invalid@example.com (AgungK) — Tue, 16 Dec 2025 10:05:43 +0000

Hi all, I need your help for solving this error, anyone have same problem with me? here for my problem,
I got this error on Remote API when add new mailbox on ISPConfig Version: 3.3.0p3 from c# asp.net.
I have success login using remote user and got session but got error:

data_processing_error
email_error_isemail
login_error_regex
data_processing_error email_error_isemail, login_error_regex, quota_error_value