Self-Hosted: Built-In Testing Commands

Last updated: September 2026

The self-hosted eCommerce Builder ships with a few built-in commands for checking that things are actually configured correctly, rather than finding out the hard way when a customer tries to check out. Run all of these with your virtual environment activated.

\r\n

Check Your Stripe Configuration

\r\n

python manage.py test_stripe

\r\n

Verifies your Stripe keys are present and valid without processing a real payment. Run this right after initial setup, and again any time you change your Stripe credentials or switch between test and live mode.

\r\n

Check Your Email Configuration

\r\n

python manage.py test_email --to your-email@example.com

\r\n

Validates the SMTP connection, tests authentication, and sends an actual test email so you can confirm delivery end to end. Run this after setting up email, and again after changing any SMTP credential.

\r\n

Check Your Migrations Match Your Models

\r\n

python manage.py makemigrations --check

\r\n

Confirms there's no mismatch between your database schema and your code before you deploy. Run this before every update, especially if you've made any customisations of your own.

\r\n

Run the Full Test Suite

\r\n

python manage.py test

\r\n

Runs the application's full automated test suite. This is mainly useful if you (or a developer you've hired) have modified the code and want to confirm nothing else broke as a result.

\r\n

When to Run These

\r\n
    \r\n
  • Right after initial setup, before you go live: test_stripe and test_email
  • \r\n
  • Any time you change a Stripe or SMTP credential: the matching one of the two above
  • \r\n
  • Before every update or deploy: makemigrations --check
  • \r\n
  • After any custom code change: test
  • \r\n
\r\n
\r\n

← Back to the Managed Hosting vs Self-Hosting Guide