Basic Configuration

Poweradmin supports two configuration formats: legacy (individual PHP variables) and modern (array-based configuration).

Configuration Files

With any new installation, the file config/settings.defaults.php (or in legacy versions, inc/config-defaults.inc.php) is distributed. You should not edit this file as your changes will likely be overwritten during upgrades.

Instead: - Modern format: Create config/settings.php - Legacy format: Create inc/config.inc.php

Your custom settings will override the defaults. This way, new configuration options can be added with sensible defaults without breaking your existing configuration.

Legacy Configuration Format

This is the traditional format, still supported for backwards compatibility:

<?php
$db_host = 'localhost';
$db_name = 'powerdns-db';
$db_user = 'poweradmin-db-user';
$db_pass = 'poweradmin-db-user-password';
$db_type = 'mysql';

$session_key = 'generate-some-random-text-here';

$dns_hostmaster = 'hostmaster.example.net';
$dns_ns1 = 'ns1.example.net';
$dns_ns2 = 'ns2.example.net';

Modern Configuration Format

The recommended modern format uses a PHP array structure:

<?php
return [
    'database' => [
        'host' => 'localhost',
        'name' => 'powerdns-db',
        'user' => 'poweradmin-db-user',
        'password' => 'poweradmin-db-user-password',
        'type' => 'mysql',
    ],

    'security' => [
        'session_key' => 'change_this_key',
    ],

    'dns' => [
        'hostmaster' => 'hostmaster.example.com',
        'ns1' => 'ns1.example.com',
        'ns2' => 'ns2.example.com',
    ],
];

Configuration Sections

The modern configuration format is organized into logical sections:

• database: Database connection settings
• security: Security-related settings including password policies and session management
• dns: DNS-specific configurations including nameserver details
• interface: UI and display preferences
• logging: Logging configuration
• pdns_api: PowerDNS API integration settings
• mail: Email configuration for notifications
• dnssec: DNSSEC functionality settings
• ldap: LDAP authentication settings
• misc: Miscellaneous settings like timezone and edit conflict handling

Configuration Variables

The following configuration variables are available in the legacy format, with their modern array format equivalents:

Database Settings

API Settings

Security Settings

Interface Settings

* Default enabled languages: cs_CZ, de_DE, en_EN, fr_FR, it_IT, ja_JP, lt_LT, nb_NO, nl_NL, pl_PL, ru_RU, tr_TR, zh_CN

DNS Settings

Timezone Settings

Logging Settings

DNSSEC Settings

LDAP Settings

LDAP search filter examples:

$ldap_search_filter = '(memberOf=cn=powerdns,ou=groups,dc=poweradmin,dc=org)';
$ldap_search_filter = '(objectClass=account)';
$ldap_search_filter = '(objectClass=person)(memberOf=cn=admins,ou=groups,dc=poweradmin,dc=org)';
$ldap_search_filter = '(cn=*admin*)';

Other Settings

For detailed information about specific settings, see:

• Database Configuration
• DNS Settings
• Security Policies
• PowerDNS API
• LDAP Integration
• Logging Setup

Important Notes

1. When using the modern format, all settings should be included in the array structure
2. The legacy format is maintained for backward compatibility but new installations should use the modern format
3. Never commit sensitive information like passwords to version control
4. Always change default values, especially the session_key, in production environments
5. Make sure to set appropriate file permissions on your configuration file