< All Topics
Print

Common Admin Mistakes & Fixes

Common Admin Mistakes & Fixes
Common mistakes that admins make and how to resolve them.

SMTP Domain Verification

If outbound emails are not sending and you’re using a custom domain for the “From Email” address, it’s likely due to domain verification requirements.

  • Check the DNS settings for the domain you’re sending from to ensure it has the correct SPF, DKIM, and DMARC records.
  • Verify that your email provider (e.g., Mailgun, SendGrid) has your domain authenticated and that you’ve completed all required steps in their dashboard.
Fix: Ensure that the domain is verified with your email provider and that the domain’s SPF and DKIM settings match their requirements.

S3 IAM Permissions

If you’re having trouble with S3 uploads (e.g., “Access Denied” errors), the issue is likely related to IAM permissions.

  • Ensure that the IAM role or user has the following permissions:
    • s3:PutObject (upload files)
    • s3:GetObject (read files)
    • s3:ListBucket (list contents of the bucket)
  • Ensure the Bucket Policy and CORS configuration allow the necessary actions from your application.
Fix: Update IAM policy or bucket permissions to include the correct actions and ensure there are no conflicting permissions.

Database Restore Rollback

When restoring a database, it’s critical to ensure the backup file is correct before proceeding. Restoring the wrong backup could result in data loss.

  • Before restoring, confirm the backup date and contents by checking the file name and verifying the backup via your preferred method (e.g., viewing records in SQLite).
  • Ensure that a current backup exists before restoring to prevent data loss from the most recent changes.
Fix: Always confirm the backup file before restoring and ensure your last backup was successful.

Backup File Format Issues

If you’re seeing issues with backup files (e.g., file size is zero or cannot be opened), it’s usually caused by:

  • Partial Backup: The database was in use during the backup process.
  • File Corruption: A system crash or failure occurred during the export process.
Fix: Retry the backup process, ensuring that no users are accessing the database during the process.

Table of Contents