Metadata-Version: 2.4
Name: certbot-dns-hostinger
Version: 0.1.0
Summary: Certbot DNS plugin for Hostinger
Project-URL: Homepage, https://github.com/BackBenchDevs/certbot-dns-hostinger
Project-URL: Repository, https://github.com/BackBenchDevs/certbot-dns-hostinger
Project-URL: Issues, https://github.com/BackBenchDevs/certbot-dns-hostinger/issues
Project-URL: Changelog, https://github.com/BackBenchDevs/certbot-dns-hostinger/releases
Author-email: A M <am@bbdevs.com>
License: Apache-2.0
Keywords: acme,certbot,dns,hostinger,letsencrypt,ssl,tls
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: acme>=4.2.0
Requires-Dist: certbot>=4.2.0
Requires-Dist: hostinger-api>=0.0.15
Requires-Dist: urllib3>=2.2.1
Description-Content-Type: text/markdown

Certbot DNS Plugin for Hostinger
================================

.. image:: https://img.shields.io/pypi/v/certbot-dns-hostinger.svg
   :target: https://pypi.org/project/certbot-dns-hostinger/
   :alt: PyPI version

.. image:: https://img.shields.io/pypi/pyversions/certbot-dns-hostinger.svg
   :target: https://pypi.org/project/certbot-dns-hostinger/
   :alt: Python versions

.. image:: https://img.shields.io/pypi/l/certbot-dns-hostinger.svg
   :target: https://github.com/BackBenchDevs/certbot-dns-hostinger/blob/main/LICENSE
   :alt: License

.. image:: https://img.shields.io/pypi/dm/certbot-dns-hostinger.svg
   :target: https://pypi.org/project/certbot-dns-hostinger/
   :alt: Downloads

.. image:: https://img.shields.io/badge/certbot-%3E%3D4.2.0-blue.svg
   :target: https://pypi.org/project/certbot/
   :alt: Certbot version

This plugin automates the process of completing a ``dns-01`` challenge by creating, and subsequently removing, TXT records using the Hostinger API.

Installation
-----------

.. code-block:: bash

    pip install certbot-dns-hostinger

Usage
-----

.. code-block:: bash

    certbot certonly \\
        --dns-hostinger \\
        --dns-hostinger-credentials /path/to/credentials.ini \\
        -d example.com

Named Arguments
--------------

``--dns-hostinger-credentials PATH``
    Hostinger credentials INI file. (Required)

Credentials
----------

Create a credentials file:

.. code-block:: ini

    # /path/to/credentials.ini
    dns_hostinger_api_token = <your-api-token>

The file should be readable by the Certbot process and secure (``chmod 600``).

API Token
---------

To obtain an API token:

1. Log in to your Hostinger account
2. Go to `https://hpanel.hostinger.com/domains`
3. Navigate to API section
4. Generate a new API token with DNS management permissions

Examples
--------

Obtain a single certificate for all subdomains of a domain:

.. code-block:: bash

    certbot certonly \\
        --dns-hostinger \\
        --dns-hostinger-credentials ~/.secrets/certbot/hostinger.ini \\
        -d example.com \\
        -d *.example.com

Use a custom propagation delay:

.. code-block:: bash

    certbot certonly \\
        --dns-hostinger \\
        --dns-hostinger-credentials ~/.secrets/certbot/hostinger.ini \\
        --dns-hostinger-propagation-seconds 120 \\
        -d example.com

Troubleshooting
--------------

If you encounter any issues, check:

1. API token is correct and has proper permissions
2. Domain is managed by Hostinger
3. Credentials file is readable and secure
4. Network connectivity to Hostinger API

For more information, see the `Certbot documentation <https://eff-certbot.readthedocs.io/>`_.
