/freenom-auto-renew-domains

A scraper built with puppeteer that auto renew free domains on Freenom and send discord message using webhook

Primary LanguageJavaScript

Auto renew domain

Freenom Auto Renew Domains

Description

This application is a scraper built with puppeteer that will send discord message with webhook to list your domains, their status and how many days it left before it needs a renew. This application will also auto renew you free domains when it's possible. (auto renewal is deactivated by default for paid domains, but in a future update you'll be able to manage auto renew with discord commands)

It is highly recommended using this app under a process manager like pm2, as it become a background process that will run on your server. If you don't have a dedicated server that is always on, consider using Heroku.

Warning

Due to lack of accessible data on freenom and to avoid unwanted behavior, please be sure at the first start that there is no free domains renewable.

You can take a look here My Freenoms Domains.

If you have free domain that is renewable please renew it before starting this tool. In this way, free domain won't be considered as paid domain and set auto renew to false by default while creating database for the first time. Of course, for the next launches of the tool, you don't mind about having free domains renewable, the tool will automatically renew it if the first start was execute as described before.

Prerequisites

  • node >= 11
  • npm
  • pm2

Quickstart

npm install
cp .env.sample .env
pm2 start app.js --name "FreenomAutoRenewDomains"

Env file

Before running for the first time, you need to fill your .env file with your own values.

DB_NAME=freenoms-domains
CHROME_PATH=/usr/bin/chromium-browser
DISCORD_WEBHOOK_ID=
DISCORD_WEBHOOK_TOKEN=
FREENOM_LOGIN=email
FREENOM_PASS=password
FREENOM_CRONJOB="0 9 * * 1"
  • DB_NAME: The name of the local sqlite3 db used to saved domain data and preferences (like auto renew)
  • CHROME_PATH: The path to a chromium browser used by puppeteer
  • DISCORD_WEBHOOK_ID: The discord webhook ID used to send domains status and auto renew information on your discord server (More info on Discord Support)
  • DISCORD_WEBHOOK_TOKEN: The discord webhook TOKEN used to send domains status and auto renew information on your discord server
  • FREENOM_LOGIN: Your email of your Freenom account
  • FREENOM_PASS: Your password of your Freenom account
  • FREENOM_CRONJOB: The cronjob rule on you want to schedule auto renew. By default, the cronjob rule is set at 09 AM every Monday. (More info on Crontab.guru)

Examples

Listing domains with infos

Auto renewal