checkdomain
Find the first available domain name for a keyword by checking .com, .net, .org, .info, .biz, .co, and .me with whois
- Command:
/go/checkdomain - Category: Domains
- Required option: A keyword
- Output: The first available domain, or nothing
- Last updated: 2026-11-20
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
- Logs the run to
/var/log/go/checkdomain.log. - Removes everything from the first dot of the argument.
- 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..., orNo entri.... - Prints the first name that matches and stops.
Known issues
- A failed lookup (no network, a rate limit, or a server error) looks the same as a taken name. The command cannot tell the difference, so it stays silent.
- The keyword is not checked. An empty argument or a name with spaces or invalid characters is passed to
whoisas it is. - The phrases are broad, and the word
AVAILABLEis case-sensitive, so a free name can be missed or a taken name can occasionally be reported as free. - Only the seven endings above are checked.
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 |