Skip to content
Maran

How it works

API error codes

Every error code the panel API can answer with, its HTTP status and what it means, so a billing system can branch on the code rather than parse a sentence.

A refused request answers with a problem document (RFC 7807), and the field to read is code. It is machine-stable and never translated: a caller branches on it. The title and detail carry the same failure as a sentence in the caller's language (English, Russian or Armenian, from Accept-Language), and correlationId names the request in the server's log.

json
{
  "type": "https://httpstatuses.io/400",
  "title": "A site cannot have more additional hostnames than one certificate can cover.",
  "status": 400,
  "detail": "A site cannot have more additional hostnames than one certificate can cover.",
  "code": "SiteAliasLimitExceeded",
  "correlationId": "0HN7…"
}

The status comes from the kind of failure

Every code has one kind, set where the code is defined. The HTTP status comes from the kind alone, not from how the code is spelled.

HTTPKindWhat it tells the caller
400ValidationThe request could have been sent differently. Fix it before retrying.
401UnauthorizedNot signed in, or the credential is no longer good.
403ForbiddenRefused for a reason that discloses nothing about anyone else.
404Not foundThe thing does not exist, or does not exist for this caller.
409ConflictWell-formed, but it disagrees with what already exists.
429Rate limitedToo many attempts; wait and retry.
500FailureThis server failed at something the caller could not influence.
502Upstream refusedA party outside the panel answered and refused: a certificate authority, a mail server, a package mirror.
503UnavailableSomething could not be reached or cannot take the work now; retrying later is the advice.

A resource that belongs to another account answers 404, never 403, as described on the API page.

Codes worth knowing first

  • RequestParameterInvalid (400). A value the panel cannot read at all, such as ?page=abc, ?pageSize=x or ?status=7 (a status that does not exist). The sentence names the parameter. A parameter with a code of its own keeps it: a search text that is too long is ListSearchTooLong and an unknown sort is ListSortUnknown.
  • AgentPackageSourceRefused (502) and AgentPackageSourceUnreachable (503). Installing a PHP version failed because the package mirror refused the download or could not be reached. The server itself is fine, so retry later. A failure on the server itself is still AgentSystemFailure (500).
  • AgentBelowFreeSpaceFloor (503). The server is below its free-space floor, so creating an account, taking or restoring a backup, or accepting an upload was refused before anything was written. The floor and how to change it are on the recovery page.
  • The panel certificate: PanelHostNameNotConfigured (409), PanelCertificateNotIssued (404), PanelChallengeWriteFailed (500). Ordering a trusted certificate for the panel's own address needs Panel__HostName set. If issuance fails, the panel keeps the certificate it was already serving. The certificate authority's own answers are the Acme… codes under Certificates below. Ordering the certificate is described under Panel certificate.
  • SiteAliasLimitExceeded (400). More than 99 aliases on one site; see websites.
  • CurrentPasswordIncorrect (400). A wrong current password when changing your own; see recovery.

A failed background task carries the same codes

Work that runs as a background task (a backup, a restore, a PHP install, a certificate order) does not fail with an HTTP response; the task does. GET /api/v1/tasks, GET /api/v1/tasks/running, GET /api/v1/tasks/{id} and every frame of GET /api/v1/tasks/{id}/stream carry the reason as failure, which is null for a task that did not fail:

json
"failure": {
  "code": "AgentBelowFreeSpaceFloor",
  "message": "The server is nearly out of disk space, so it refused to start this and nothing was changed. Free some space on the server, then try again."
}

The code is one of those below. The message is resolved each time the task is read, in the reader's language, so it is the same sentence the code carries as an error response. A code no installed module describes reads as TaskFailureUnexplained's sentence, with the original code kept in code.

Every code

294 codes, taken from the error definitions of the panel's source: each module's ErrorMessages table, the server agent's and the request-value codes. The meaning is the sentence the API sends. AccountNotFound and SiteNotFound are raised by more than one module and appear under each. In RequestParameterInvalid, "…" stands for the name of the parameter. The 20 codes for resellers, membership offers, resending an invitation, skipping the final backup and verifying a backup are not in 1.0.0-beta.4; they arrive with the next release.

  1. task: never an HTTP response. The code appears only as a background task's failure.code.
  2. n/a: defined in the panel's messages, but no current code path raises it.
  3. log stream: the closing frame of a live log stream, not an HTTP response.

Request values

CodeHTTPMeaning
ListPageOutOfRange400The page number must be 1 or greater.
ListPageSizeNotOffered400The page size must be 10, 25, 50 or 100.
ListSearchInvalid400The search text contains characters that are not allowed.
ListSearchTooLong400The search text can be at most 100 characters long.
ListSortUnknown400This list cannot be sorted that way.
RequestParameterInvalid400The value given for “…” cannot be read.

The panel itself

CodeHTTPMeaning
HostForbidden403You do not have access to this page.
HostRateLimited429Too many requests were sent in a short time. Please wait until the time given in the Retry-After header has passed, then try again.
HostTwoFactorSetupRequired403Finish setting up two-factor authentication first.
HostUnexpectedError500Something went wrong and this request could not be completed. Please try again. If it keeps happening, contact support and give them the correlation id shown with this message. They need it to find your request.
HostViewAsNotAllowed403This action is not available while you are viewing as this account.
HostValidationFailed400Some of the details you entered are not valid.

The server agent

CodeHTTPMeaning
AgentAccountSuspended409The account is suspended, so this was refused and nothing was started. Resume the account, then try again.
AgentAlreadyExists409This already exists on your server, so nothing was created again.
AgentBelowFreeSpaceFloor503The server is nearly out of disk space, so it refused to start this and nothing was changed. Free some space on the server, then try again.
AgentCertificateUnreadable400The certificate could not be read. Check that you pasted the whole certificate, including its BEGIN and END lines.
AgentFirewallPortsMisconfigured500The firewall was not changed, because this panel does not know which ports must stay open on your server. Nothing was changed. Please contact support.
AgentIncompatible503The panel and the service that manages your server are at different versions, so this request was not carried out. An update may still be in progress; please try again later, and contact support if it keeps happening.
AgentInvalidInput400Some of the details you submitted were not accepted. Please check them and try again.
AgentInvalidResponse500Your server did not return a usable answer. Please try again in a few minutes, and contact support if it keeps happening.
AgentLimitReached409Your plan's limit for this kind of item was already reached, so nothing was created. Delete one you no longer need, or ask for a larger plan, then try again.
AgentNotFound404This no longer exists on your server. Refresh the page to see its current state.
AgentNotImplemented503Your server does not support this option yet, so nothing was done. Choose another option, or contact support to find out when it will be available.
AgentPackageSourceRefused502A package repository your server installs from refused the download, so nothing was installed. The fault is with that repository, not your server; please try again later, and contact support if it keeps happening.
AgentPackageSourceUnreachable503No package repository your server installs from could be reached, so nothing was installed. This is usually a temporary network problem; please try again in a few minutes, and contact support if it keeps happening.
AgentPrivateKeyMismatch400The private key does not belong to this certificate. Paste the key that was created together with the certificate request.
AgentPrivateKeyUnreadable400The private key could not be read. Check that you pasted the whole key, including its BEGIN and END lines, and that it is not protected by a passphrase.
AgentRunNotStopped500The server could not confirm that the operation was stopped, so it may still be running. Check on it before you try again.
AgentSaturated503The server is already running as many of these as it allows, so nothing was started. Wait a moment for one to finish, then try again.
AgentSystemFailure500This operation could not be completed on your server and nothing was changed. Please try again in a few minutes, and contact support if it keeps happening.
AgentUnavailable503Your server is not answering right now, so this request could not be confirmed. Please try again in a minute, and contact support if it keeps happening.
AgentUnspecified500This operation could not be completed on your server. Please try again in a few minutes, and contact support if it keeps happening.
AgentValidationFailed400Your server rejected these details as invalid. Please correct them and try again.

Hosting accounts

CodeHTTPMeaning
AccountCleanupFailed500The account was not deleted: something it owns could not be removed first. Nothing has been changed; please try again.
AccountDomainTaken409This domain is already used by another account.
AccountDomainWwwPrefix400Enter the primary domain without www., for example example.com.
AccountFeatureNotGranted403You have not been given access to this feature. Ask the account owner.
AccountFinalBackupSkipForbidden403A reseller cannot skip the final backup when deleting an account. Ask an administrator, or let the backup run.
AccountHomeGroupRepairCountInvalid400The number of homes to repair cannot be negative. Read the report again and confirm the figure it gives.
AccountHomeGroupRepairPlanChanged409The host's home directories no longer match the report you read, so nothing was repaired and nothing was changed. Read a fresh report and confirm its figures before repairing.
AccountLoginIssuanceFailed500The account was created, but the login for its owner could not be issued. Do not create the account again; resend the invitation instead.
AccountNameInvalid400This account name is not valid. Use 3 to 30 lowercase letters, digits or underscores, starting with a letter.
AccountNameReserved400This account name is reserved for the system and cannot be used. Choose another name.
AccountNameTaken409This account name is already taken.
AccountNotFound404This account could not be found.
AccountOwnerLanguageUnsupported400Choose the owner's language from the list: English, Russian or Armenian.
AccountPlanQuotaBelowUsage409The plan was not changed: this account already uses more disk than the new plan's quota allows, and moving it would stop it from writing files. Choose a plan with a larger quota, or free space on the account first.
AccountResumptionFailed500The account was not reactivated: something it runs could not be started again. Nothing has been changed; please try again.
AccountResumptionNotObserved500The account was not reactivated: the server could not be observed to have started it again. Nothing has been changed; please try again.
AccountStatusUnknown400This account status is not one the panel knows. Use active or suspended.
AccountSuspensionFailed500The account was not suspended: something it runs could not be stopped first. Nothing has been changed; please try again.
AccountSuspensionNotObserved500The account was not suspended: the server could not be observed to have stopped it. Nothing has been changed; please try again.
PlanFeatureNotIncluded403This feature is not included in your plan.
PlanFeatureUnknown400A plan feature must be one of the features the panel lists.
PlanInUse409This plan was not deleted: accounts are still on it. Move those accounts to another plan or delete them first.
PlanNameTaken409Another plan already has this name.
PlanNotFound404This plan could not be found.
PlanOwnerMismatch409This plan and this account belong to different owners. An account can only use a plan of its own reseller, and an administrator's account only an administrator's plan.
PlanQuotaBelowUsage409The plan was not changed: an account on it already uses more disk than the new quota allows, and lowering the quota would stop that account from writing files. Raise the quota, or free space or move that account to another plan first.
ResellerAccountLimitReached409The reseller has reached the number of accounts it was sold. Ask an administrator to raise its limit.
ResellerDiskPoolExceeded409This would take the reseller past the disk space it was sold. Choose a smaller plan or ask an administrator to enlarge its disk pool.
ResellerEnvelopeInvalid400The reseller's limits are not valid. Every figure must be zero or more and within the allowed maximum, and every resource ceiling must be positive.
ResellerHasAccounts409The reseller was not deleted: it still owns accounts or plans. Delete them first.
ResellerLoginIssuanceFailed500The reseller was created, but its login could not be issued. Delete the reseller and create it again once the cause in the server log is fixed.
ResellerNameInvalid400This reseller name is not valid. Use 3 to 30 lowercase letters, digits or underscores, starting with a letter. The reseller signs in with this same name.
ResellerNameTaken409This name is already used by another reseller or by a hosting account.
ResellerNotFound404This reseller could not be found.
ResellerPlanExceedsEnvelope400This plan goes beyond what the reseller was sold: a figure is above its ceiling or a feature is not included. Lower the figures or remove the feature.
ResellerPlanLimitReached409The reseller has reached the number of plans it was sold. Delete a plan or ask an administrator to raise its limit.
ResellerSuspended409This reseller is suspended, so it cannot make changes. An administrator has to reactivate it first.

Backups

CodeHTTPMeaning
AccountBackupOperationRunning409Your server is still working on another backup or restore for this account. Nothing was changed. Try again once that operation has finished.
AccountNotFound404This account could not be found.
BackupArtifactUnvouchedtask¹The panel stopped following this backup before your server reported a result. A copy of that backup IS on your server, but the panel never recorded its checksum, so it cannot verify the copy and will not offer it for restore. It is recorded as failed and the copy was not deleted. Ask support to release the space, or start a new backup.
BackupCancelledtask¹The backup was cancelled before it finished.
BackupDateRangeInverted400The start of the date range must not be later than its end.
BackupDestinationKindUnknown400That is not a kind of backup destination.
BackupDestinationLocalAlreadyDefined409This server already has its local backup destination, and it can have only one.
BackupDestinationNameInvalid400A backup destination needs a name of at most 64 characters.
BackupDestinationNotConfigured409This server has no default backup destination, so nothing can be backed up until it is reconciled at the next start.
BackupDestinationNotFound404That backup destination does not exist.
BackupDestinationRemoteUnsupported400This build stores backups on this server only. S3-compatible storage is not available.
BackupInvalidOutcometask¹The server agent reported a finished backup with nothing to identify it by.
BackupKindUnknown400That is not a kind of backup.
BackupNotFound404This backup could not be found.
BackupNotRestorable409This backup cannot be restored: it did not finish successfully.
BackupNotVerifiable409This backup cannot be verified: it did not finish successfully.
BackupOutcomeUnobservedtask¹The panel stopped following this backup before your server reported a result, so it cannot say whether the copy was finished. It is recorded as failed and is not offered for restore. Start a new backup, and contact support if this keeps happening.
BackupScheduleDayNotAllowed400A daily schedule cannot name a day of the week.
BackupScheduleDayRequired400A weekly schedule must name the day of the week it runs on.
BackupScheduleHourOutOfRange400The hour must be between 0 and 23.
BackupScheduleRetainOutOfRange400The number of backups to keep must be between 1 and 365.
BackupScheduledRunAbortedtask¹The scheduled backup stopped before the server agent reported how it ended.
BackupStatusUnknown400That is not a backup status.
BackupStillRunning409This backup is still being made and cannot be deleted yet.
BackupStreamDroppedtask¹The connection to the server agent was lost while the backup was being made.
BackupStreamIdletask¹The server agent stopped reporting progress while the backup was being made.
BackupTruncatedtask¹The server agent stopped without saying how the backup ended.
BackupVerificationArtifactMissing404The stored archive could not be found.
BackupVerificationFailed400The stored archive no longer matches its record.
FinalBackupFailed500The account was not deleted: its final backup could not be made.
RestoreArtifactRejected400Your server refused this copy: what it holds is not what the panel recorded when the copy was made. Nothing was restored and the account is unchanged. Restore from another copy, or contact support. Submitting the same request again will not resolve this.
RestoreCancelled500The restore was cancelled before it finished.
RestoreConfirmationMismatch409The name you typed is not this account's user name.
RestoreConfirmationRequired400Type the account's user name exactly to confirm the restore.
RestoreInvalidOutcome500The server agent reported a finished restore without saying what it restored.
RestoreOutcomeUnobservedtask¹The panel stopped following this restore before your server reported a result, so it cannot say how far it got. The account may already have been replaced: check its files and databases before starting another restore, and contact support if you are unsure.
RestorePartial500The restore did not replace everything it set out to; the account is only partly restored.
RestoreStreamDropped503The connection to the server agent was lost while the account was being restored.
RestoreStreamIdle503The server agent stopped reporting progress while the account was being restored.
RestoreTruncated500The server agent stopped without saying what the restore had done.

Scheduled tasks

CodeHTTPMeaning
AccountNotFound404This account could not be found.
CronCommandInvalid400This command is not valid. It must be a single line and at most 4096 bytes.
CronEntryAlreadyExists409You already have a scheduled task with this schedule and command.
CronEntryIdInvalid400This scheduled task identifier is not valid.
CronEntryLimitReached409Your plan does not allow any more scheduled tasks.
CronEntryLimitReachedConcurrently409Your plan's limit on scheduled tasks was reached by another request made at the same moment, so this task was not created. Nothing you entered is wrong. Delete a scheduled task you no longer need, or ask for a larger plan, then try again.
CronEntryNotFound404This scheduled task could not be found.
CronEntrySuspended409The account is suspended, so its scheduled task was not run. Resume the account, then try again.
CronEnvironmentDuplicateName400The same variable name was sent twice.
CronEnvironmentInvalid400The environment variables sent could not be read.
CronEnvironmentNameInvalid400A variable name may only contain uppercase letters, digits and underscores, and may not start with a digit.
CronEnvironmentNameReserved400MAILTO and SHELL are managed by the server and cannot be set here.
CronEnvironmentTooManyVariables400Too many environment variables were sent.
CronEnvironmentValueInvalid400A variable value may not contain a percent sign, a control character, surrounding spaces or wrapping quotes.
CronOperationFailed500This scheduled task could not be changed. Nothing was altered; please try again.
CronRunAccountLimitReached409Too many scheduled tasks of your account are running right now. Wait for one to finish, then try again.
CronRunAgentSaturated503The server's scheduler is already running as many scheduled tasks as it allows, so this one was not started. Nothing was changed; wait a moment for one to finish, then try again.
CronRunNotFound404This run could not be found.
CronRunNotStopped500This scheduled task was started by hand, but the server could not confirm that it was stopped, so it may still be running. Check on it before you run it again, because another run would start beside the first.
CronRunOutcomeUnknown400This run outcome is not one the panel recognises.
CronRunServerBusy503The server is running a lot of scheduled tasks right now, so this one was not started. Nothing was changed; please try again in a moment.
CronScheduleInvalid400This schedule is not valid. Use five cron fields, such as 0 3 * * 1.

Running a task by hand is bounded so one account cannot occupy the server's workers. An operator can change the two limits with Cron__Runs__MaxConcurrentPerAccount (default 2, per account) and Cron__Runs__MaxConcurrentGlobal (default 16, across all accounts) in /etc/maran/panel.env; both are whole numbers of at least 1 and the panel refuses to start with any other value. CronRunAccountLimitReached answers when the account is at its own limit; CronRunServerBusy answers when the server as a whole is, and is worth retrying. A run that hit the output limit has its job stopped, and the run is reported as stopped only once the server has confirmed it. When that confirmation fails the answer is CronRunNotStopped (500): the job may keep running until the server's runtime ceiling ends it, so check the entry's output before running it again. Every run is audited, and a run is written to the audit log even if the browser disconnects while the task is still running.

Databases

CodeHTTPMeaning
AccountNotFound404This account could not be found.
DatabaseGrantRepairCountInvalid400The number of grants to repair cannot be negative. Read the report again and confirm the figure it gives.
DatabaseGrantRepairPlanChanged409The server's grants no longer match the report you read, so nothing was repaired and nothing was changed. Read a fresh report and confirm its figures before repairing.
DatabaseLimitReached409Your plan does not allow any more databases.
DatabaseLimitReachedConcurrently409Your plan's database limit was reached by another request made at the same moment, so this database was not created and no password was issued. Nothing you entered is wrong. Delete a database you no longer need, or ask for a larger plan, then try again.
DatabaseNameInvalidFormat400A database name may only contain lowercase letters and digits.
DatabaseNameTaken409You already have a database with this name.
DatabaseNameTooLong400This name is too long once your account prefix is added.
DatabaseNotFound404This database could not be found.
DatabaseProvisioningFailed500This database could not be created. Nothing was left behind; please try again.
DatabaseUserNameInvalidFormat400A database user name may only contain lowercase letters and digits.
DatabaseUserNameTaken409You already have a database user with this name.
DatabaseUserNameTooLong400This user name is too long once your account prefix is added.

Firewall

CodeHTTPMeaning
BanAddressInvalid400This is not an address the firewall can ban.
BanAddressLoopback400A loopback address cannot be banned: this host accepts loopback traffic before any ban is consulted, so the ban would block nothing. Ban the address the traffic reaches this server from instead, the one shown for the connection, not 127.0.0.1 or ::1.
BanDurationInvalid400A ban lasts between one minute and one year; leave the duration empty for a permanent ban.
BanNotFound404No ban is in force for this address.
RulePortInvalid400A firewall rule must name a port between 1 and 65535.
RulePortRangeInvalid400A firewall rule that opens a range of ports must end above where it starts, and inside 1 to 65535.
RuleProtocolInvalid400A firewall rule applies to TCP or to UDP.
RuleSourceCidrInvalid400The source range must be written in CIDR notation, with no host bits beyond the prefix.
WhitelistCidrInvalid400The range must be written in CIDR notation, with no host bits beyond the prefix.
WhitelistCidrTaken409This range is already on the whitelist.
WhitelistEntryNotFound404This whitelist entry could not be found.
WhitelistEntryProtectsCaller409Removing this range would stop exempting the address you are connected from, and a mistyped password could then lock you out of this server. Add an exemption that also covers this address and remove this one afterwards, or remove it while connected from another address.

FTPS

CodeHTTPMeaning
AccountNotFound404This account could not be found.
FtpUserLimitReached409Your plan does not allow any more FTPS users. Delete one you no longer need, or ask for a larger plan.
FtpUserLimitReachedConcurrently409Your plan's FTPS user limit was reached by another request made at the same moment, so this user was not created and no password was issued. Nothing you entered is wrong. Delete an FTPS user you no longer need, or ask for a larger plan, then try again.
FtpUserNameInvalidFormat400An FTPS user name may only contain lowercase letters and digits, and may not be empty.
FtpUserNameTaken409This FTPS user name is already taken. Please choose another one.
FtpUserNameTooLong400This FTPS user name is too long. Your account prefix is added to it, so choose a shorter one.
FtpUserNotFound404This FTPS user could not be found. Refresh the page to see the FTPS users you have.
FtpUserProvisioningFailed500This FTPS user could not be created and no password was issued. Please try again. If the name is then reported as already taken, contact support: a leftover login may have to be removed.
FtpsCertificateMissing409FTPS cannot start until a TLS certificate exists for this host name. Nothing you entered is wrong: issue or install a certificate for it in the SSL section, then enable FTPS again.
FtpsHostnameInvalidFormat400This is not a valid host name. Enter a name such as ftp.example.com.
FtpsHostnameNotServed400This panel does not serve a site for this host name. Add the site first, then enable FTPS for it.
FtpsHostnameReserved400This name cannot be used for the FTPS server.
FtpsHostnameTooLong400This host name is too long. A host name may be at most 253 characters.
FtpsPassiveAddressInvalid400The passive address must be an IPv4 address written plainly, such as 203.0.113.7, with no leading zeros. A host name or an IPv6 address is not accepted, because the PASV reply has no form for it. Leave it blank if your server is not behind NAT.

Users, sign-in and invitations

CodeHTTPMeaning
AccountMembershipNotFound404This account could not be found.
AccountMembershipSuspended409This account is suspended, so it cannot be used until it is resumed.
AdminRecoveryLoginNotActive409That administrator's login is not active (it is suspended or still awaiting its first password), so it cannot be recovered from the console.
AdminRecoveryNotAdministrator409That user is not an administrator. Only administrators can be recovered from the console.
AdminRecoveryUserNotFound404No user with that e-mail address or username exists.
AuditActionFilterInvalid400That is not an action the audit journal can record.
AuditDateRangeInverted400The start of the date range must not be later than its end.
AuditOutcomeUnknown400That is not an outcome an audit entry can have.
CurrentPasswordIncorrect400The current password is not correct.
EmailInvalidFormat400Enter a valid email address.
EmailTaken409This email address is already registered.
InvalidCredentialsUnauthorized401; 400 if empty or too longThe username or password is incorrect.
InvalidTwoFactorCodeClockUnsynchronizedUnauthorized401That code is not valid. The server's clock is not synchronised, which can make correct codes fail. Ask the server's administrator to check its time synchronisation.
InvalidTwoFactorCodeUnauthorized401That code is not valid. Check your authenticator app and try again.
InvitationAccountNotFound404; 400 if the id is emptyNo such hosting account.
InvitationAccountSuspended409No invitation can be issued while this account is suspended. Reactivate the account first.
InvitationLoginNotPending409There is nothing to invite this account's owner to: the login already has a password.
InvitationTokenInvalid400That invitation link is no longer valid. Ask an administrator to resend it.
MembershipOfferAccountSuspended409This account is suspended, so the offer cannot be accepted right now.
MembershipOfferNotFound404That offer does not exist or is no longer open.
PasswordResetEmailInvalid400Enter a valid e-mail address.
PasswordResetTokenInvalid400That password reset link is no longer valid. Request a new one.
PasswordTooWeak400Choose a password of at least the minimum length your administrator has set (12 characters by default).
PasswordTooLong400That password is too long. Choose a shorter one.
PasswordSameAsUsername400Choose a password that is different from your username.
PinnedPageAlreadyPinned409That page is already pinned.
PinnedPageKeyInvalid400That is not a page that can be pinned.
PinnedPageLimitReached409You have pinned as many pages as you can. Unpin one first.
PinnedPageNotFound404That page is not pinned.
RefreshTokenInvalidUnauthorized401Your session has ended. Please sign in again.
RefreshTokenReusedUnauthorized401Your session was ended for security reasons. Please sign in again.
SecurityPolicyInvalid400Those security settings are outside the range the panel accepts.
SessionNotFound404This session could not be found.
SetupAlreadyCompletedForbidden403This panel has already been set up.
SetupTokenExpiredUnauthorized401This setup token has expired, so no administrator was created: for safety the installer's one-time token stops working a set time after the panel is installed. Nothing you entered is wrong. To claim this server, set a new setup token in the panel's environment configuration, restart the panel, and enter that new token here.
SetupTokenInvalidUnauthorized401This setup link is not valid.
SubUserFeatureInvalid400Choose the features from the list the panel offers.
SubUserLimitReached409Your account already has the most sub-users it may hold. Remove one before inviting another.
SubUserNotFound404That sub-user does not exist.
SubUserNotPending409That person has already accepted the invitation, so there is nothing to resend.
SubUsersOwnerOnly403Only the owner of the account can manage its sub-users.
TwoFactorAlreadyEnabled409Two-factor authentication is already enabled.
TwoFactorNotEnabled409Two-factor authentication is not enabled.
TwoFactorRequiredUnauthorizedn/a²Enter the code from your authenticator app to finish signing in.
UserNotFound404This user could not be found.
UsernameInvalidFormat400A username may contain only letters, digits, dots, dashes and underscores.
UsernameTakenn/a²This username is already taken.
ViewAsAccountNotFound404That account was not found, or it has no login to view as.
ViewAsLoginUnavailable409The account's login is suspended or locked, so the panel cannot be viewed as it.
ViewAsNotViewing409You are not viewing the panel as an account.
ViewAsResellerNotFound404That reseller was not found, or it has no login to view as.

Licence

CodeHTTPMeaning
LicenceInstallExpired400The submitted licence's validity period has already ended. Nothing was installed and the previous licence, if any, is unchanged. Renew the licence and submit the renewed file.
LicenceInstallFingerprintMismatch400The submitted licence was issued for a different server than this one. Nothing was installed and the previous licence, if any, is unchanged. Use your licence's self-service transfer to move it to this server, or contact support if you believe this is wrong.
LicenceInstallMalformed400The submitted licence file is not in a shape this panel can read. It may have been copied incompletely or edited, or it may not be a licence file at all. Nothing was installed and the previous licence, if any, is unchanged. Download a fresh copy of your licence and try again without editing it.
LicenceInstallProductMismatch400The submitted licence file was issued for a different product and cannot be used here. Nothing was installed and the previous licence, if any, is unchanged. Submit the licence file issued for this panel instead.
LicenceInstallSignatureInvalid400The submitted licence file's signature does not match its contents, which means the file was changed after it was issued, or is not genuine. Nothing was installed and the previous licence, if any, is unchanged. Get a fresh copy of your licence rather than editing this one by hand, and submit that instead.
LicenceInstallTextRequired400No licence text was submitted. Paste or upload the licence file's contents.

Mail

CodeHTTPMeaning
MailDeliveryFailed502The mail server refused the message.
MailRecipientInvalid400The recipient must be one plain e-mail address, with no display name.
MailServerUnreachable503No mail server answered at the configured address. Check the host and port, or try again later.
SmtpAlertRecipientInvalid400The alert recipient must be one plain e-mail address, with no display name.
SmtpFromAddressInvalid400The sender must be one plain e-mail address, with no display name.
SmtpFromNameInvalid400The sender's display name must be a single line of ordinary text.
SmtpHostInvalid400The mail server's name is required and must be a single line of ordinary text.
SmtpNotConfigured400The panel has no outgoing mail settings yet, so nothing was sent.
SmtpPasswordInvalid400The submission password is longer than this panel accepts.
SmtpPortInvalid400The mail server's port must be between 1 and 65535.
SmtpSecurityInvalid400Choose one of the offered ways to protect the connection.
SmtpUsernameInvalid400The submission user name must be a single line of ordinary text.

SFTP

CodeHTTPMeaning
AccountNotFound404This account could not be found.
SftpUserLimitReached409Your plan does not allow any more SFTP users.
SftpUserLimitReachedConcurrently409Your plan's SFTP user limit was reached by another request made at the same moment, so this user was not created and no password was issued. Nothing you entered is wrong. Delete an SFTP user you no longer need, or ask for a larger plan, then try again.
SftpUserNameInvalidFormat400An SFTP user name may only contain lowercase letters and digits.
SftpUserNameTaken409You already have an SFTP user with this name.
SftpUserNameTooLong400This name is too long once your account prefix is added.
SftpUserNotFound404This SFTP user could not be found.
SftpUserProvisioningFailed500This SFTP user could not be created. Nothing was left behind; please try again.

Websites

CodeHTTPMeaning
AccountNotFound404This account could not be found.
PhpInstallOutcomeUnobserved500The server did not report whether this PHP version was installed. Nothing here can say it was, so it is reported as failed: check the server's package manager before trying again, because a half-finished install is the one state this cannot tell apart from a slow one.
PhpVersionInvalidFormat400This is not a valid PHP version.
PhpVersionNotInstallable400This PHP version cannot be installed on this server.
PhpVersionNotInstalled400This PHP version is not installed on the server.
SiteAliasDuplicated400The same hostname is listed more than once.
SiteAliasInvalidFormat400One of the additional hostnames is not a valid domain name.
SiteAliasLimitExceeded400A site cannot have more additional hostnames than one certificate can cover.
SiteAliasReserved400One of the additional hostnames cannot be used for a site.
SiteBackendNotPhp400This site does not run PHP, so it has no PHP version to change.
SiteBackendTypeUnknown400That is not a kind of site backend.
SiteDomainInvalidFormat400This is not a valid domain name.
SiteDomainReserved400This name cannot be used for a site.
SiteDomainTaken409This domain is already used by another site.
SiteLimitReached409Your plan does not allow any more sites.
SiteLimitReachedConcurrently409Your plan's site limit was reached by another request made at the same moment, so this site was not created. Nothing you entered is wrong. Delete a site you no longer need, or ask for a larger plan, then try again.
SiteLogHistoryLinesInvalid400That is more history than a log request may replay.
SiteLogSourceInvalid400This is not a log this site keeps.
SiteLogTailFailedlog stream³This log could not be read.
SiteNotFound404This site could not be found.
SiteProxyUpstreamInvalidFormat400This is not a valid upstream address.
SiteStatusUnknown400That is not a site status.

Certificates

CodeHTTPMeaning
AccountNotFound404This account could not be found.
AcmeAccountRejected502The certificate authority refused this server's registration.
AcmeAuthorityUnreachable503The certificate authority could not be reached. Please try again later.
AcmeCertificateUnreadable502The certificate the authority issued could not be read.
AcmeChallengeTokenInvalid502The certificate authority sent a verification token this server will not accept.
AcmeChallengeUnavailable503The certificate authority offered no challenge this server can answer.
AcmeChallengeWriteFailed500The verification file could not be placed in this site's document root.
AcmeOrderRejected502The certificate authority refused the order for this domain.
AcmeValidationFailed502The certificate authority could not verify this domain. Check that it points to this server.
AcmeValidationTimedOut503The certificate authority did not finish verifying this domain in time.
CertificateAlreadyExists409This domain already has a certificate.
CertificateDomainInvalidFormat400This is not a valid domain name.
CertificateDomainReserved400A certificate cannot be issued or installed for this name.
CertificateNotFound404This certificate could not be found.
CertificatePemInvalid400The certificate chain is not valid PEM: it must contain a block that begins with -----BEGIN CERTIFICATE-----.
CertificatePemRequired400Paste the certificate chain in PEM form.
CertificatePemTooLarge400The certificate chain is too large: it may be at most 65,536 characters.
CertificateStatusUnknown400That is not a certificate status.
PanelCertificateNotIssued404No trusted certificate has been issued for the panel; it is served with its self-signed certificate.
PanelChallengeWriteFailed500The verification file for the panel's host name could not be placed on the server.
PanelHostNameNotConfigured409The panel has no host name configured, so no certificate can be ordered for it. Set Panel__HostName in /etc/maran/panel.env and restart the panel.
PrivateKeyPemInvalid400The private key is not valid PEM: it must contain a block that begins with -----BEGIN and ends with PRIVATE KEY-----.
PrivateKeyPemRequired400Paste the private key in PEM form.
PrivateKeyPemTooLarge400The private key is too large: it may be at most 65,536 characters.
SiteNotFound404This site could not be found.

Log level

CodeHTTPMeaning
LogLevelUnknown400That is not a log level the panel offers.

Background tasks

CodeHTTPMeaning
TaskAbandonedByRestarttask¹The panel restarted while this task was running, so it did not finish.
TaskDateRangeInverted400The start of the date range must not be later than its end.
TaskFailureUnexplainedtask¹The operation did not finish, and this panel has no description of why. The code below identifies the failure; quote it when you ask for help.
TaskKindFilterInvalid400That is not a kind of background task the panel can record.
TaskNotFound404This background task could not be found.
TaskStatusUnknown400That is not a state a background task can be in.