GoAdmio

checkdomain

Find the first available domain name for a keyword by checking .com, .net, .org, .info, .biz, .co, and .me with whois

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/checkdomain takes a keyword and finds a domain name for it that is not registered yet. It asks the whois service about the keyword with seven endings, one after another, and stops at the first one that looks free.

The endings are checked in this order:

.com → .net → .org → .info → .biz → .co → .me

It returns one domain, the first available in that order. It does not list all the available names.


Quick start

/go/checkdomain mybrand
mybrand.net

In this example mybrand.com is taken and mybrand.net is free.


Syntax

/go/checkdomain <keyword>
Argument Description
<keyword> One word, for example mybrand. Hyphens are fine.

Options

None. The command takes one argument, and the list of endings cannot be changed.

If you type a full domain name, everything from the first dot is removed and the rest is used as the keyword. mybrand.net is checked as mybrand, and the ending you typed is ignored. The check always starts with .com.


Output

Result Meaning
mybrand.net The first domain in the list that looks available.
(nothing) All seven were reported as taken, or the lookups failed.

The command does not print an error and does not say how many names it checked. Each run also adds a line to /var/log/go/checkdomain.log.

The exit status is 1 when a domain is found and 0 when none is found, which is the reverse of the usual meaning. Use the printed output, not the status.


Examples

# Find a name for a keyword
/go/checkdomain mybrand
# Use the result in a script
Domain=$(/go/checkdomain mybrand)
if [ -z "$Domain" ]; then
    echo "No domain found"
else
    echo "Available: $Domain"
fi
# Check one specific domain yourself
whois mybrand.com

Troubleshooting

Symptom Likely cause Fix
Nothing is printed All seven names are taken, or whois failed. Run whois <keyword>.com yourself and read the answer. Then try another keyword.
Nothing is printed for a name you know is free whois could not reach the server, or the server limited your requests. Wait a few minutes and run it again.
whois: command not found whois is not installed. Install the whois package.
The command is slow It runs up to seven lookups, one after another. Wait, or check a single name with whois.
A name is reported as available but cannot be registered The whois answer is only a hint. The name may be reserved, a premium name, or already taken since. Confirm the name with your domain registrar.
The wrong ending is returned The order of endings is fixed. Check the ending you want with whois <keyword>.<ending>.

Details

How it works

  1. Logs the run to /var/log/go/checkdomain.log.
  2. Removes everything from the first dot of the argument.
  3. For each ending, runs whois <keyword>.<ending> and looks in the answer for a phrase that means the name is free: No match, NOT FOUND, Not fo..., AVAILABLE, No Data Fou..., has not been regi..., or No entri....
  4. Prints the first name that matches and stops.

Known issues


See also

Command Description
create Create a GoAdmio account from the command line
dns Add your domain to Cloudflare and edit the DNS zone
nameservers Change the nameservers for a GoAdmio server
expire Check hosting and domain expiry dates and send email/WhatsApp notifications