English English Українська Українська Français Français Español Español
Namingo

Namingo EPP

Namingo EPP is an open-source PHP EPP client that enables seamless connection to EPP servers for domain registration and management. It supports multiple EPP extensions, integrates easily with any PHP framework, and is fully customizable for various domain registries.

The client also provides EPP modules for WHMCS and FOSSBilling, supporting all essential features for efficient domain management.

Install

To begin, simply follow the steps below. This installation process is optimized for a VPS running Ubuntu 22.04/24.04 or Debian 12.

Minimum requirement: a VPS with at least 1 CPU core, 2 GB RAM, and 10 GB hard drive space. Please use PHP 8.2 or PHP 8.3.

1. Navigate to your project directory and run the following command:

composer require pinga/tembo

2. In your PHP code, include the Connection.php file from the Tembo package:

require_once 'Connection.php';

3. To create test certificates (cert.pem and key.pem), if the registry does not have mandatory SSL certificates, you can use:

openssl genrsa -out key.pem 2048
openssl req -new -x509 -key key.pem -out cert.pem -days 365

4. You can now use the EppClient class and its functions in your code. You can refer to the examples directory for examples of how the package can be used.

5. To test if you have access to the EPP server from your system, you may use:

openssl s_client -showcerts -connect epp.example.com:700
openssl s_client -connect epp.example.com:700 -CAfile cacert.pem -cert cert.pem -key key.pem

6. If the registry you need to connect gave you certificates in P12 format, you will need to convert them to PEM using:

openssl pkcs12 -in your_certificate.p12 -clcerts -nokeys -out cert.pem
openssl pkcs12 -in your_certificate.p12 -nocerts -out key.pem
openssl rsa -in key.pem -out newkey.pem

Supported EPP Commands

command domain contact host session
check login ✅
checkClaims N/A N/A logout ✅
info poll ✅
create hello ✅
createDNSSEC N/A N/A keep-alive ✅
createClaims N/A N/A new password ✅
update N/A
updateNS N/A N/A
updateContact N/A N/A
updateAuthinfo N/A N/A
updateStatus
updateDNSSEC N/A N/A
renew N/A N/A
delete
transferRequest
transferQuery
transferApprove
transferReject
transferCancel
rgp:restore N/A N/A
rgp:report N/A N/A

Supported Connection Types

type status
EPP over TLS/TCP
EPP over HTTPS
RRI
TMCH
REGRR

Registry Support (37 backends and counting)

Registry TLDs Extension Status TODO
Generic RFC EPP any
AFNIC .fr/others FR
CARNET .hr HR
Caucasus Online .ge
CentralNic all
CoCCA all
CORE/Knipp all
DENIC .de
Domicilium .im
DOMREG .lt LT 🚧 work on extensions
DRS.UA all
EURid .eu EU
FORTH-ICS .gr, .ελ GR
FRED .cz/any FRED domain update NS/DNSSEC
GoDaddy Registry all
Google Nomulus all
Hostmaster .ua UA
Identity Digital all
IIS .se, .nu SE
HKIRC .hk HK
NASK .pl PL
Namingo all
NIC Chile .cl
NIC Mexico .mx MX
NIC.LV .lv LV
NORID .no NO
.PT .pt PT
Registr.io all
Registro.it .it IT 🚧 work on extensions
RoTLD .ro
RyCE all
SIDN all more tests
SWITCH .ch, .li
Traficom .fi FI only org contacts; more tests
Verisign all VRSN
ZADNA .za
ZDNS all

Integration with billing systems

Would you like to see any registry added as a WHMCS/FOSSBilling module? Or an EPP module for any other billing system? Simply create an issue in this project and let us know.

WHMCS

Registry TLDs Status Project
Generic RFC EPP any whmcs-epp-rfc
Hostmaster .ua whmcs-epp-ua
EURid .eu whmcs-epp-eurid

FOSSBilling

Registry TLDs Status Project
Generic RFC EPP any fossbilling-epp-rfc
Hostmaster .ua fossbilling-epp-ua
FRED .cz/any fossbilling-epp-fred
AFNIC .fr/others fossbilling-epp-fr
Caucasus Online .ge fossbilling-epp-ge

Issues?

If you have any questions or need further information, feel free to reach out at help@namingo.org or join our Discord channel.