Skip to content

A WebDriver-based automated renewal system for Freenom domains

Notifications You must be signed in to change notification settings

TheManchineel/freenew

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

freenew: renew your Freenom domains automatically

image image image

freenew will regularly check your Freenom domain names to see if they are eligible for renewal. If so, it will renew them for you.

As of 2023 Freenom no longer allows domain registrations, so this tool is only useful for renewing existing domains even if they are across multiple accounts.

Installation (Docker)

The recommended way to run freenew is using Docker. This will ensure that all dependencies are installed and configured correctly, including the web driver for Selenium.

First, create a valid config.json file on your host system. See the Configuration section for details.

Then, run the following command:

docker run -d --name freenew -v /path/to/config.json:/app/config.json --restart unless-stopped manchineel/freenew

freenew will handle renewing your domains automatically.

Configuration

Configuration is done using a config.json file. An example:

{
    "accounts": [
        {
            "username": "[email protected]",
            "password": "1234",
            "excluded_domains": ["domain_i_dont_want_to_renew.gq"]
        },
        {
            "username": "[email protected]",
            "password": "abcd",
            "excluded_domains": []
        }
    ],
    "account_interval_seconds": 300,
    "crontab": "0 16 * * *"
}

Domain names in the excluded_domains array will not be renewed, even if they are eligible for renewal.

The account_interval_seconds value is the number of seconds to wait between each separate account sign-in. This is to avoid Freenom blocking your IP address for too many login attempts (although this has not been an issue for me, and I have made lots of logins).

The crontab value is a crontab expression that determines how often freenew will check for domain renewals. A possible value is 0 16 * * *, which means that freenew will check for renewals at 16:00 UTC every day. Changes require a restart of the Docker container to take effect.

About

A WebDriver-based automated renewal system for Freenom domains

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published