Self-Test

The Self-Test feature runs diagnostic checks on your ATStatus installation to identify configuration issues, connectivity problems, and potential errors.

When to Run Self-Test

Run the self-test after installation, after configuration changes, or when troubleshooting issues. It's a quick way to verify everything is working correctly.

Running Self-Test

Log in to the Admin Panel
Navigate to Self-Test in the sidebar
Click Run All Tests
Review the results

Test Categories

The self-test checks multiple aspects of your installation:

🗄️ Database

Database connection
Schema integrity
Read/write permissions

📧 Email (SMTP)

SMTP server connection
Authentication
Send capability (optional test email)

🔔 Notifications

Discord webhook connectivity
Webhook URL validity
Notification queue status

🔒 Security

Session secret configured
HTTPS/SSL status
Cookie security settings

⚙️ Configuration

Required environment variables
File permissions
Disk space

Understanding Results

Status	Icon	Meaning
Pass	✅	Test completed successfully
Warning	⚠️	Works but may need attention
Fail	❌	Test failed, action required
Skipped	⏭️	Test not applicable or disabled

Common Issues & Fixes

Database Connection Failed

Possible Causes:

Incorrect DATABASE_URL in .env
Database file permissions (SQLite)
Database server not running (PostgreSQL/MySQL)

SMTP Test Failed

Possible Causes:

Wrong SMTP credentials
Firewall blocking SMTP ports
Need app password instead of regular password
See SMTP Configuration Guide

Discord Webhook Failed

Possible Causes:

Invalid webhook URL
Webhook deleted in Discord
Network connectivity issues

Session Secret Warning

Possible Causes:

Using default session secret
Secret too short
Set a strong, random SESSION_SECRET in .env

Running Individual Tests

You can run specific tests instead of all tests:

Go to Self-Test page
Find the test category you want
Click the Run button next to that test

Sending Test Notifications

From the Self-Test page, you can send test notifications to verify your setup:

Test Email - Sends a test email to a specified address
Test Discord - Sends a test message to your Discord webhook

Pro Tip

Use test notifications after any configuration changes to verify everything still works. It's better to catch issues during setup than during an actual incident.

Still Having Issues?

If self-test identifies problems you can't resolve:

Check the specific error message carefully
Review the relevant configuration guide
Check the Troubleshooting page
Verify environment variables are set correctly
Check server/network logs for more details

Self-Test Best Practices

Run after initial installation
Run after any configuration changes
Run periodically to catch issues early
Fix warnings before they become failures
Document any known issues or exceptions