Help center

Error codes

Every error a Raytown plugin can show, by number. The first digit tells you where it came from: 1 is your computer, 2 to 6 is the license server answering, 9 is a fault on our side. A "Get help" button in the plugin lands here at the exact code.

On your computer

1101 - 1302 · The plugin found the problem before or instead of talking to the server.

1101CERT_MISSING

License file missing

"No license file was found on this computer."

What it means
Normal after a fresh install, a reset, or a cleanup tool that deleted it. The plugin shows as not activated.
What to do
Activate again with your license key and email, or use Restore. If every seat is in use, free one first.

Read more: The plugin says "Not activated"

1102CERT_SIGNATURE_INVALID

License file damaged

"The license file on this computer failed its security check."

What it means
The file was changed or corrupted after the server issued it, so the plugin will not trust it.
What to do
Activate again; the plugin replaces the file. If this keeps happening, email support with this code.

Read more: The plugin says "Not activated"

1103CERT_PAYLOAD_MISMATCH

License file is for another machine

"The license file is for a different computer or plugin."

What it means
Renaming the computer, a major operating system upgrade, or copying the file from another machine all cause this.
What to do
Activate on this computer. It takes a seat, so free the old machine first if every seat is in use.

Read more: The plugin says "Not activated"

1104CERT_EXPIRED

License needs to check in

"This license has gone 30 days without checking in."

What it means
Some plugin versions use a license that renews every 30 days while you are online. This one was not renewed in time, so the plugin shows as not activated. Your license and seat are not lost. Versions with a perpetual license never show this.
What to do
Connect to the internet and open the plugin; it checks in and unlocks on its own. Still locked while online? See the firewall and proxy article.
Clarity DelayClarity Delay 1.1.x re-checks the license about once a month when you are online. Connect to the internet and open the plugin, then update to Clarity Delay 1.2.0, which never needs to check in.

Read more: Firewalls, proxies and captive portals

1105CERT_WRITE_FAILED

Couldn't save the license file

"The plugin could not save its license file on this computer."

What it means
The license folder is not writable. Folder permissions, a sync or cleanup tool, a full disk or antivirus software can all block it. The plugin stays not activated until the file is saved.
What to do
Make sure the license folder is writable: on Windows, %APPDATA%\Raytown Productions\; on macOS, ~/Library/Application Support/Raytown Productions/. Then activate again. If it keeps happening, email support with this code.

Read more: The plugin says "Not activated"

1201CONNECTION_FAILED

Can't reach the license server

"The plugin could not connect to licensing.raytownproductions.com."

What it means
No internet, a DNS problem, or a firewall or proxy blocking your DAW. Only activating, restoring and checking in need the internet.
What to do
Check your connection, allow your DAW through the firewall, then try again.

Read more: Firewalls, proxies and captive portals

1202TIMEOUT

License server timed out

"The license server did not answer in time."

What it means
The connection was made, but no reply came within 15 seconds. Usually a slow or unstable network.
What to do
Wait a minute and try again. If it keeps happening, email support.

Read more: Firewalls, proxies and captive portals

1203TLS_FAILURE

Secure connection failed

"The plugin could not make a secure (HTTPS) connection."

What it means
Something broke the security check between you and the server: usually a wrong system clock, a proxy that inspects HTTPS, or an out-of-date operating system.
What to do
Set the correct date and time, install operating system updates, or try a network without the proxy.

Read more: Firewalls, proxies and captive portals

1301BAD_RESPONSE

Unexpected server reply

"The license server's reply could not be read."

What it means
Something other than the server answered, usually a Wi-Fi sign-in page (hotel, airport) or a proxy.
What to do
Open a browser, finish any Wi-Fi sign-in, then try again.

Read more: Firewalls, proxies and captive portals

1302RESPONSE_SIGNATURE_INVALID

Server reply not trusted

"The license the server sent failed its security check."

What it means
The plugin only saves licenses signed by Raytown Productions. This one was not, so nothing was saved.
What to do
Try again. If it repeats, email support with this code and your plugin version.

License

2101 - 2104 · The license server answered about the license itself.

2101LICENSE_NOT_FOUND

License not foundHTTP 404

"No license matches that key and email."

What it means
The server has no license for this key, email and plugin.
What to do
Copy the key and email from your purchase receipt. Bought with a different email? Use Restore.

Read more: Restoring a lost license key

2102LICENSE_REVOKED

License revokedHTTP 403

"This license is no longer active."

What it means
It was transferred to a new owner, or revoked by Raytown Productions.
What to do
If you think this is a mistake, email support from the address you bought with.
2103LICENSE_SUSPENDED

License on holdHTTP 403

"This license is on hold."

What it means
The order was refunded, the payment is disputed, or support has paused the license.
What to do
Email support with your order email and this code.
2104TRIAL_UPGRADED

Key replaced by an upgradeHTTP 403

"This key was replaced when you upgraded. Use your new key."

What it means
Buying the full version or a higher tier retired this key. The plugin normally switches to the new key on its own; you see this when it can't.
What to do
Activate with the key from your purchase email, or use Restore to have it sent again.

Read more: Restoring a lost license key

Activation and machines

3101 - 3105 · Seats, machine ids and clocks.

3101NOT_ACTIVATED

Machine not activatedHTTP 403

"This computer is not activated on that license."

What it means
The license does not list this computer. Renaming it, a major operating system upgrade, or a reset all make it look like a new machine.
What to do
Activate again. If every seat is in use, free the old machine from the plugin's Machines tab or the license portal.

Read more: Moving a license to another computer

3102ACTIVATION_FAILED

Activation failedHTTP 403

"The server could not finish the activation."

What it means
Two changes to this license's seats arrived at once, and this one lost.
What to do
Try again. If it repeats, email support with this code.
3103SEAT_LIMIT_REACHED

All activation seats in useHTTP 403

"Every activation seat on this license is in use."

What it means
Each license runs on a set number of machines, three unless yours says otherwise, and all of them are taken.
What to do
Free a machine you no longer use from the plugin's Machines tab or the license portal, then activate this one.

Read more: Moving a license to another computer

3104INVALID_MACHINE_ID

Machine ID not validHTTP 400

"The plugin sent a machine ID the server rejected."

What it means
The ID the plugin made for this computer was too short or malformed.
What to do
Restart your DAW and try again. If it persists, email support with your operating system version.
3105CLOCK_TAMPERED

System clock is behindHTTP 403

"Your computer's clock is set earlier than before."

What it means
The clock is more than a day behind a time already seen on this computer, by the plugin itself or by the license server. Trials check this so they cannot be extended; paid licenses are not affected.
What to do
Turn on automatic date and time, then try again.

Trials

4101 - 4105 · Trial lifecycle and email verification codes.

4101TRIAL_EXPIRED

Trial endedHTTP 403

"Your free trial has ended."

What it means
The trial period for this plugin is over.
What to do
Buy a license to keep using it. Your settings and presets are kept.
4102TRIAL_ALREADY_ACTIVE

Trial already usedHTTP 409

"This email has already had a trial of this plugin."

What it means
Each email gets one trial per plugin.
What to do
If the trial is still running, keep using it on the computer where you started it. Otherwise, buy a license.

Read more: How trials work

4103TRIAL_LOCKED

Trial seats are fixedHTTP 403

"A trial's machines can't be changed until it ends."

What it means
Trial seats stay with the computers the trial was started on.
What to do
Keep using the trial where it is, or buy a license; paid seats can be freed and moved.

Read more: How trials work

4104INVALID_CODE

Code not acceptedHTTP 400

"That verification code is not valid."

What it means
Codes expire after 10 minutes and stop working after 5 wrong tries. The code may also be for a different email.
What to do
Request a new code and enter it within 10 minutes.
4105MISSING_CODE

Code requiredHTTP 400

"Enter the 6-digit code from your email first."

What it means
The request arrived without a verification code.
What to do
Request a code, then enter the 6 digits from the email.

Restore and portal

5101 - 5107 · Self-service restore and license-portal sessions.

5101RATE_LIMITED

Too many attemptsHTTP 429

"Too many attempts. Please try again later."

What it means
Restore limits how many licenses one account can claim in an hour.
What to do
Wait up to an hour, then try again.
5102SESSION_EXPIRED

Restore session expiredHTTP 401

"Your restore session expired. Start again."

What it means
A restore session lasts 30 minutes, and this one ran out.
What to do
Start the restore again from the beginning.

Read more: Restoring a lost license key

5103NOT_FOUND

License not on this accountHTTP 403

"That license is not on this account."

What it means
The license you picked does not belong to the email you restored with.
What to do
Restore with the email the license was bought with; it is on your receipt.

Read more: Restoring a lost license key

5104NOT_RESTORABLE

License can't be restoredHTTP 403

"This license cannot be restored automatically."

What it means
Only active paid licenses can be restored. Trials, and licenses that were refunded, put on hold, upgraded, transferred or revoked, cannot.
What to do
Email support with your order email.
5105NOT_A_SEAT

Machine not on this licenseHTTP 403

"That machine is not on this license anymore."

What it means
The machine you chose to free was already removed.
What to do
Refresh the machine list and try again.

Read more: Moving a license to another computer

5106STILL_FULL

Seats still fullHTTP 403

"All seats are still in use."

What it means
A seat was freed, but another activation took it first.
What to do
Free another machine, or email support.

Read more: Moving a license to another computer

5107UNAVAILABLE

License not available for restoreHTTP 403

"This license is not available for restore right now."

What it means
The license is in a state that restore does not handle.
What to do
Email support with your order email.

Request problems

6101 - 6103 · The plugin sent something the server could not read.

6101INVALID_REQUEST

Request not understoodHTTP 400

"The server could not read the request."

What it means
The request arrived garbled, usually because of a proxy or an out-of-date plugin.
What to do
Update the plugin and try again away from any proxy. If it persists, email support.
6102MISSING_FIELDS

Request incompleteHTTP 400

"Some required information was missing."

What it means
A field the server needs, such as the email, was empty.
What to do
Fill in every field and try again. If they are all filled in, update the plugin.
6103INVALID_EMAIL

Email not validHTTP 400

"Enter a valid email address."

What it means
That does not look like an email address.
What to do
Check for typos and try again.

Server faults

9101 - 9199 · Something failed on our side.

9101EMAIL_SEND_FAILED

Email could not be sentHTTP 500

"The server could not send the verification email."

What it means
Our mail service failed to send it.
What to do
Check the address and try again in a few minutes. If it persists, email support.
9199INTERNAL

Server errorHTTP 500

"The license server hit an unexpected error."

What it means
Something failed on our side.
What to do
Try again in a few minutes. If it persists, email support with this code and the time it happened.