Documentation

Everything you need to install, configure, and operate Simple PHP IPAM.

Installation

Requirements, web server setup (Apache, nginx, Caddy, OLS), file permissions, and first login steps.

Configuration

Settings UI walkthrough and all configuration keys explained — SMTP, OIDC, housekeeping, scanning.

Upgrading

Using upgrade.sh, CLI migration utilities, v3.0 breaking changes, and multi-engine migration paths.

REST API

Authentication, all endpoints, query filters, pagination, bulk write, and example curl calls.

OIDC Authentication

SSO setup, IdP-specific examples (Keycloak, Authentik, Azure AD, Google), user provisioning and auto-link.

Security

HTTPS enforcement, rate limiting, session hardening, audit log, API key management, and security headers.

SMTP Configuration

Direct SMTP setup with TLS/STARTTLS, Gmail, Office 365, AWS SES, Mailgun, and Postfix examples.

Network Scanning

ICMP and TCP scan configuration, cron scheduling, stale address thresholds, and ARP import workflow.

Devices & Interfaces

Link IP addresses to named devices and interfaces, manage equipment inventory, and use the REST API and CSV import.

Advanced Networking

VRF BGP attributes, VLAN ranges, aggregates, IPv6 Prefix Delegation pools, and DNS zone export.

Webhooks

HMAC-signed outbound webhooks on address and subnet events — setup, payload reference, signature verification, and retry behaviour.

Backup & Restore

Unified 5-tab admin surface (Destinations, Backup, History, Restore, Notifications) with drawer-driven CRUD. S3 / SFTP / Local destinations with streaming AES-256-CTR + HMAC-SHA256 encryption, GFS retention, cron-driven schedules, and email failure notifications. History tab has a per-row detail drawer (Verify SHA-256 / Download / DELETE-confirmed Delete) and filter chips by Status / Backup type / Time.

Restore Database

Phase-locked browser-based restore wizard: stage from any destination, dry-run preview with a real-lexer SQL splitter, then live apply behind a literal-string RESTORE confirm gate. Covers both Logical (PDO replay) and Database (engine-native dump) restore paths, with same-or-newer cross-version policy. Full audit trail; rate-limited; CLI fallback for disaster recovery.

DHCP Config Export

Generate server-ready dhcpd.conf or Kea 2.x JSON from subnet options and reservations. Per-subnet routers, DNS, lease times, and PXE boot settings.

Contacts

Link contacts to IP addresses via the Owner typeahead. Reusable people / org records with name, email, phone, and notes that surface as clickable owner cards in the address list.

Custom Fields

Admin-defined per-entity metadata on subnets and addresses — text, number, date, boolean, and select types with strict validation.

Sidebar & Command Palette

Desktop sidebar layout, mobile hamburger overlay, and the ⌘K / Ctrl+K command palette for keyboard-driven navigation and record creation.