Troubleshooting
Where to look first, and fixes for cron, e-mail, ownership verification, licence states, 403, 404, 500 and 503 errors, maintenance mode, sign-in problems and the error log.
When something does not work, start with the same three places: the Dashboard (cron, licence, security events), Reports → E-mail Log and Reports → Automation Log, and Settings → System & Maintenance → Log (the file errors.log). Most problems are visible in one of them. This chapter lists the common problems with their cause and cure, grouped by area.
1. The first look
| Place | What it tells you |
|---|---|
| Dashboard, Automation (cron) | Running, Late or Never ran. |
| Dashboard, Licence | The state of the licence. |
| Dashboard, Security events | Bans, new devices, ownership changes. |
| Settings → System & Maintenance | The cron state, the failed jobs, the server checks (red marks), the database state and the log. |
| Reports → Automation Log | What each job did and the errors of the failed ones. |
| Reports → E-mail Log | Every mail, with the error when it failed. |
data/logs/errors.log | Page errors. It should be empty. |
A page that fails shows Something went wrong on this page. The error was written to the log. and a plain layout. The details are in errors.log, with the page, the message, the file and the line. To see the message on the page while you debug, switch on Show error details to staff under Settings → General Settings → Security, and switch it off again.
2. The cron does not run
| Sign | Cause | Fix |
|---|---|---|
| Dashboard says Never ran | The cron job was never added, or the command is wrong. | Add it (see Installing). Copy the exact line from the Cron card. |
| Dashboard says Late or Stopped | The job stopped, or runs less often than every 5 minutes. | Check the hosting panel's cron list and set */5 * * * *. |
| Cron mail from the host says php: command not found | The path to PHP is wrong. | Use the full path that the Cron card shows (for example /usr/local/bin/php or /opt/cpanel/ea-php82/root/usr/bin/php). |
| The web cron answers Invalid cron key (403) | The address has the wrong key, or a new key was made. | Copy the address again from the Cron card. |
| The web cron answers a login page or 404 | The address is not https://your-domain/cron.php?key=.... For a sub-folder include the folder. | Fix the address. |
| Run now says the server does not let PHP start programs | exec is disabled. | Open the web address of the cron in a browser, or use a web cron service. |
| The command works by hand but not from cron | cron uses another PHP version, or a memory limit. | Use the same PHP binary by full path. Put >/dev/null 2>&1 at the end so mails from cron stop. |
| Some jobs Failed in the Automation Log | The message column tells why (for example the exchange rate service was not reachable). | Fix the cause; run the job again from Run now. |
To test: Run now, choose Every job, tick Even if not due, and read the output. A healthy run lists each job with ok.
3. E-mails are not sent or not received
| Sign | Cause | Fix |
|---|---|---|
| Nothing in the E-mail Log | Send e-mail is off, or the template is switched off. | Settings → General Settings → E-mail: switch Send e-mail on. Settings → E-mail Templates: check the template. |
| Log says Failed with an error | The server refused. | Read the error in the log. For SMTP check host, port (587 TLS, 465 SSL), user and password; Check the server certificate off while you test. For PHP mail() try the -f switch, or move to SMTP. |
| Log says Sent but the mail never arrives | The receiving side put it in spam or dropped it. | Check the spam folder. Send from an address on your own domain, set up SPF and DKIM for it, and ask the host about the sending reputation. |
| A test mail works but member mails are late | The mail queue waits for the cron. | Fix the cron (section 2) or press Work the queue now. |
| Members do not get the verification link | Wrong address, spam folder, or a blocked provider. | Check the address under Users, press Send verification e-mail or Mark e-mail as verified, and check Banned IPs & E-mail Domains for the provider. |
| Mails show a broken logo or wrong links | Site address is empty or wrong. | Set it under General (like https://www.example.com). |
| Sellers do not get inquiry mails | They switched the e-mail off in Notifications. | The bell still shows them. Ask them to check Account Settings → Notifications. |
Always test with Send test and read the result line under the button.
4. Verification is not found
Sellers see The record was not found yet. Work through the list:
| Check | What to look for |
|---|---|
| The full host name | Typed _aiodomain-verify.example.com.example.com? The panel added the domain a second time. Use the short host. |
| The right DNS provider | The record must be where the domain's name servers point (the registrar, Cloudflare, or a hosting company). |
| The value | Exactly as shown, no quotes, no spaces at either end, no line break. |
| The type | TXT for the TXT method, CNAME for the CNAME method. |
| Cloudflare | CNAME records must be DNS only (grey cloud). |
| Time | Changes can take an hour, rarely longer. The marketplace keeps checking. Press Check now after a while. |
| The token | A newer Start verification replaces the old token. Use the record on the page now. An old one gives not found. After the token's days, The token expired. |
| CNAME target empty | The owner has not set CNAME target under the Verification settings. Use TXT or set the target. |
| DNS lookups blocked | The host disabled dns_get_record, so no record can be read. The installer would have warned. Ask the host. |
| An outside check | Look the record up with a public DNS tool. If it is not there, it is not on the internet yet. |
Staff can see what the marketplace read: open the listing, Verification tab → history; the Result column says seen: ... with the values found. If the seller truly owns the domain and cannot add a record, use Manual review or the Admin override with a note. See Verifying ownership.
5. Licence problems
| State on the Licence page | Meaning and cure |
|---|---|
| Not registered | No key. Enter it. |
| Invalid key | The key is wrong or unknown. Copy it again from lcpanel.com. |
| Registered to another domain | The key is bound elsewhere. Release it there, or ask support to change the domain. |
| Active (could not reach the License Center lately) | The server cannot reach lcpanel.com. Allow outgoing HTTPS. The marketplace works until the grace window ends. |
| Expired | Renew, then Check now. |
| Suspended, Revoked | Read the message on the page and contact support. |
| You are sent to the Licence page from every admin page | The state is not Active. Fix it, or at least reach the Licence page to activate. |
| The listing limit of N is reached | Your package's active-listing limit. Remove listings or upgrade, then Check now. |
Details are in The licence key.
6. Errors 403, 404, 500 and 503
| You see | Cause | Fix |
|---|---|---|
| 404 on every page except the home page | .htaccess is missing, or mod_rewrite / AllowOverride is off. | Upload .htaccess again (it is a hidden file). On nginx add the rewrite rule. |
| 404 on a sub-folder install | RewriteBase still says /. | Set RewriteBase /your-folder/. |
403 Forbidden on /uploads/kyc/... or /data/... | That is intended; those folders are private. | Staff open identity documents through the admin KYC page. |
403 Forbidden on /admin/pages/... | Page files are private. | Use /admin/<page> addresses. |
| Access denied: Your role does not allow this page | The signed-in role lacks the right. | Add the right under Users → Roles & Permissions, or Permissions on the user. |
| Your role does not allow this action (users.suspend) | The same, for a button. | The message names the right. |
| 403 Invalid cron key | See section 2. | |
| Page not found inside the site layout | The address is not a page. A hidden CMS page is also a 404 for visitors. | Check the address, or publish the page. |
| 500 white page | A fatal error before the layout. | data/logs/errors.log and the host's error log. Often an old PHP version, a missing extension, or a half-uploaded file. |
| 503 We are doing some maintenance | Maintenance mode is on. | See section 7. |
| Not signed in (API, 401) | An AJAX call without a session. | Sign in again. |
| 419 the form is stale | The page was open too long, or cookies are blocked, so the form's security token no longer matches. | Go back, reload the page and send the form again; check that cookies are on. |
7. Maintenance mode
With Maintenance mode on (Settings → General Settings → System), visitors and members see the notice with a 503 answer; signed-in staff see the site normally, and a yellow bar in the admin area warns that it is on.
To switch it off: sign in as staff at /admin (sign-in always works in maintenance mode), open Settings → General Settings → System, switch Maintenance mode off, and save. If you cannot sign in, set the value in the database:
UPDATE ad_settings SET value = '0' WHERE `key` = 'maintenance_mode';
(use your table prefix if it is not ad_), then press Clear the cache or delete the files in data/cache.
8. Signing in
| Problem | Cure |
|---|---|
| The e-mail address or password is not right | Check the address and the case of the password. Forgot password? sends a reset link (one hour). |
| Too many failed sign-ins from your address. Please wait a few minutes | The address is banned (5 failures in an hour, for 15 minutes by default). Wait, or another staff member removes the ban under Users → Banned IPs & E-mail Domains, or add your address to the Sign-in whitelist. |
| This account has been banned / is suspended / is closed | Read the reason; staff can lift a suspension or ban from the user's record. |
| This account has no access to the admin area | The account has no role. A staff manager sets one under Users. |
| Pending e-mail verification | Click the link in the mail, or ask staff to Mark e-mail as verified. |
| Lost phone with two-factor on | Use a recovery code. Otherwise a staff manager opens Users → [user] → Security → Switch 2FA off. If the only administrator lost it, run in the database: UPDATE ad_users SET twofa_on = 0, twofa_secret = '', twofa_recovery = '' WHERE username = 'admin'; |
| Lost the only administrator password and the reset mail does not arrive | Fix the mail first (section 3), then use Forgotten your password? on the admin sign-in page again. If mail cannot work yet, ask support for help. |
| Signed out all the time | The session cookie is blocked, the clock is wrong, or the site switches between www and the bare domain. Use one address; set Site address correctly. |
9. Listings and search
| Problem | Cause and cure |
|---|---|
| A seller cannot add a domain | E-mail not confirmed, the extension is blocked, the name is already listed (by them, or by another seller), the licence limit is reached, or the name is invalid. The page says which. |
| Verify first in the approval queue | The listing is not verified and Ownership must be verified is on. Open the Verification tab. |
| A listing is not found by search | It must be Active. A paused, pending, expired or sold listing is not searched. |
| Counts of listings per category or extension look wrong | Domains → Categories → Refresh counts, or Extensions → Refresh counts. The nightly job does it too. |
| Registrar, age or name servers are empty | The first registry lookup is queued when the listing is added and needs the cron. Press Refresh registry data on the Verification tab. RDAP needs outgoing HTTPS to the service address; WHOIS needs outgoing port 43. |
| A CSV import adds nothing | Open the result: each bad row names the reason. Check the header row, the separator (a comma), the file encoding (UTF-8), and that the seller's e-mail is confirmed. |
| An upload is refused | The file is larger than the cap (Largest upload (MB) and PHP's upload_max_filesize) or has a type the field does not accept. |
| Prices look wrong in another currency | Settings → Currencies & Rates: update the rates, or fix a rate typed by hand. |
| The sitemap is empty or old | Settings → General Settings → SEO → Rebuild the sitemap now. |
10. Speed and disk
- Use the Clear the cache button after big changes; it is safe.
- The disk fills slowly with uploads, logs and SQL backups. Delete old backups and clear logs from the System page.
- A slow admin list usually means a very large table; use the filters. The daily housekeeping job already deletes old log rows (see Reports and logs).
- For a busy marketplace, use a VPS with more memory and Redis for the cache (see Requirements).
11. Asking for help
Write to support from your account at lcpanel.com. Send:
- Your AIODomain version (the footer, or What's New) and your PHP version (the Server card).
- What you did, what you expected, and what happened (a screenshot helps).
- The last lines of
errors.logand, for mail or cron problems, the line from the E-mail Log or Automation Log. - Never send passwords, API keys, the cron key,
config.phpor a database backup in a message.