{"record":{"id":"0b442353e24efbde","repo":"appsmithorg/appsmith","slug":"failed-to-send-error-mail-admin-email-s-not-conf","errorCode":null,"errorMessage":"Failed to send error mail. Admin email(s) not configured, please refer to https://docs.appsmith.com/setup/instance-configuration/disable-user-signup#administrator-emails to configure it.","messagePattern":"Failed to send error mail\\. Admin email\\(s\\) not configured, please refer to https://docs\\.appsmith\\.com/setup/instance-configuration/disable-user-signup#administrator-emails to configure it\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"warning","filePath":"app/client/packages/rts/src/ctl/mailer.ts","lineNumber":29,"sourceCode":"  const mailUser = process.env.APPSMITH_MAIL_USERNAME;\n  const mailPass = process.env.APPSMITH_MAIL_PASSWORD;\n  const mailTo = process.env.APPSMITH_ADMIN_EMAILS;\n\n  console.log(\"Sending Error mail to admins.\");\n  try {\n    if (\n      !mailEnabled ||\n      !mailFrom ||\n      !mailHost ||\n      !mailPort ||\n      !mailUser ||\n      !mailPass\n    ) {\n      throw new Error(\n        \"Failed to send error mail. Email provider is not configured, please refer to https://docs.appsmith.com/setup/instance-configuration/email to configure it.\",\n      );\n    } else if (!mailTo) {\n      throw new Error(\n        \"Failed to send error mail. Admin email(s) not configured, please refer to https://docs.appsmith.com/setup/instance-configuration/disable-user-signup#administrator-emails to configure it.\",\n      );\n    } else if (!mailEnabled) {\n      throw new Error(\n        \"Mail not sent! APPSMITH_MAIL_ENABLED env val is disabled, please refer to https://docs.appsmith.com/setup/instance-configuration/email to enable it.\",\n      );\n    } else {\n      const backupFiles = await utils.listLocalBackupFiles();\n      const lastBackupfile = backupFiles.pop();\n      const lastBackupTimestamp = lastBackupfile.match(\n        /appsmith-backup-(.*)\\.tar.gz/,\n      )[1];\n      const lastBackupPath = Constants.BACKUP_PATH + \"/\" + lastBackupfile;\n\n      const domainName = process.env.APPSMITH_CUSTOM_DOMAIN;\n      const instanceName = process.env.APPSMITH_INSTANCE_NAME;\n\n      let text =","sourceCodeStart":11,"sourceCodeEnd":47,"githubUrl":"https://github.com/appsmithorg/appsmith/blob/8cd9021c24cdbea1c3c12c966073708e83db60c2/app/client/packages/rts/src/ctl/mailer.ts#L11-L47","documentation":"The second mail branch in sendBackupErrorToAdmins(): reached only when all six provider vars are truthy but APPSMITH_ADMIN_EMAILS (mailTo) is empty. The SMTP server is configured but there is no recipient list, so the error notification has nowhere to go.","triggerScenarios":"SMTP fully configured, but APPSMITH_ADMIN_EMAILS is unset/empty when a backup fails and the RTS attempts to notify administrators.","commonSituations":"Admin emails never set on a new instance; comma-separated list left empty after removing an admin; var name typo (e.g. APPSMITH_ADMIN_EMAIL singular).","solutions":["Set APPSMITH_ADMIN_EMAILS to a comma-separated list of admin addresses in runtime.env / container env.","Restart the RTS so the value is picked up.","Confirm the var name exactly (APPSMITH_ADMIN_EMAILS, plural) and that addresses are valid.","Optionally manage admin emails via the Appsmith admin settings UI so the same field stays in sync."],"exampleFix":"# before\nAPPSMITH_MAIL_* fully set\n# APPSMITH_ADMIN_EMAILS unset\n\n# after\nAPPSMITH_ADMIN_EMAILS=ops@example.com,oncall@example.com","handlingStrategy":"validation","validationCode":"if (!process.env.APPSMITH_ADMIN_EMAILS) throw new Error('Set APPSMITH_ADMIN_EMAILS to a comma-separated admin list.');","typeGuard":"const hasAdminEmails = (env: NodeJS.ProcessEnv): boolean => Boolean(env.APPSMITH_ADMIN_EMAILS);","tryCatchPattern":"try { await sendBackupErrorToAdmins(err, ts); } catch (e) {\n  if (/Admin email\\(s\\) not configured/i.test(e.message)) { log.warn('No admin recipients; alerting via other channel'); }\n  else throw e;\n}","preventionTips":["Set APPSMITH_ADMIN_EMAILS (plural) at install time.","Manage the list in the admin settings UI to keep it in sync.","Validate email syntax before saving the list."],"tags":["email","smtp","configuration","environment-variables","operations"],"backgroundTag":null,"analyzedSha":"8cd9021c24cdbea1c3c12c966073708e83db60c2","analyzedAt":"2026-08-12T22:14:19.293Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}