Show only problems, refresh every 30 seconds

Use light theme and auto-fullscreen for kiosk

Show paused devices and hide tags

Control Buttons
- Show Only Problems - Toggle between all monitors and problem-only view
- Show/Hide Paused - Quickly toggle paused monitor visibility
- Show/Hide Tags - Toggle tag visibility on monitor cards
- Show/Hide Filter - Toggle the tag filter section visibility
- Theme Toggle - Switch between dark and light themes
- Fullscreen - Enter/exit fullscreen mode
- Refresh Now - Manually trigger data refresh
🔒 Security Best Practices
Store Config Outside Webroot (Recommended)
The most secure approach is to store config.env outside your web-accessible directory:

If your webroot is /var/www/html/status

Store config at /var/www/html/config.env (one level up)

cat > /var/www/html/config.env << 'EOF' UPTIMEROBOT_API_TOKEN=your-token-here

... other settings ...

chmod 600 /var/www/html/config.env chown www-data:www-data /var/www/html/config.env

The application automatically searches parent directories for the config file.
If Storing in Webroot
If you must store config.env in the webroot:
1. Set restrictive permissions:
   `bash
   chmod 600 config.env
   `
2. Verify .htaccess protection (Apache):
   `bash
   curl http://your-domain.com/status/config.env
   # Should return 403 Forbidden
   `
3. For Nginx users, add to your server block:
   `nginx
   location ~ /config\.env {
       deny all;
       return 403;
   }
   `
Security Checklist
- ✅ config.env returns 403 when accessed via HTTP
- ✅ File permissions set to 600 (owner read/write only)
- ✅ config.env is in .gitignore (never commit secrets!)
- ✅ Consider storing outside webroot for maximum security
🎨 Themes
Dark Theme (Default)

Light Theme
Switch themes using:
- The theme toggle button in the UI
- ?theme=dark, ?theme=light, or ?theme=auto URL parameter
- THEME setting in config.env
🏷️ Tag Filtering
Filter your monitors by tags for better organization and focused monitoring. Each monitor displays its assigned tags as colored pills, making it easy to visually identify and categorize services.
Features
- Colored Tag Pills - Each tag displays with a unique, deterministic color for easy visual identification
- Multi-Tag Filtering - Select one or more tags to filter monitors (OR logic - shows monitors with ANY selected tag)
- Collapsible Filter - Toggle filter visibility with "Show Filter" / "Hide Filter" button
- Clear Filters - One-click to reset all tag selections
- Real-time Updates - Instant filtering as you select/deselect tags
Filter Section
Click "Show Filter" to reveal all available tags. Click any tag to filter monitors:
Filtered View
When tags are selected, only monitors with those tags are displayed. The selected tags appear highlighted with increased opacity and a shadow effect.
How to Use
1. View Tags - All monitors display their tags as colored pills at the bottom of each card
2. Show Filter - Click the "Show Filter" button in the controls to reveal the tag filter section
3. Select Tags - Click one or more tags to filter monitors. Selected tags are highlighted
4. Clear Filter - Click "Clear Filter" to remove all selections and show all monitors
5. Hide Filter - Click "Hide Filter" to collapse the filter section
Benefits
- Quick Organization - Instantly filter to Production, Staging, API, Database, or any custom tags
- Multi-Environment - Separate views for different environments or regions
- Team Workflows - Filter by team ownership, criticality, or service type
- Visual Clarity - Color-coded tags make it easy to scan and identify services at a glance
Custom Tag Colors
You can customize tag colors using the TAG_COLORS configuration option in config.env. This accepts a JSON object with two optional configurations:
1. Define acceptable color palette:

2. Map specific tags to specific colors:

3. Combine both approaches:

Supported color formats include:
- Hex codes: #FF0000, #abf7b1
- CSS color names: red, blue, orange, green
- RGB/HSL formats: rgb(255,0,0), hsl(120,100%,50%)
If not specified, colors are automatically generated from tag names using a deterministic algorithm for consistent coloring across page reloads.
🖥️ Kiosk Mode
Perfect for dedicated monitoring displays:
1. Set up auto-fullscreen:
   `bash
   # In config.env
   AUTO_FULLSCREEN=true
   `
2. Or use URL parameter:
   `
   https://your-domain.com/status/?autoFullscreen=true&showProblemsOnly=true
   `
3. Combine with browser kiosk mode for an immersive experience
🔧 Troubleshooting
No data showing
- Check browser console for errors (F12)
- Verify API token is correct in config.env
- Ensure uptimerobot_status.php is accessible
- Check uptime_errors.log for PHP errors
Configuration not loading
- Verify config.env file exists and has correct permissions
- Check file format: KEY=value (no spaces around =)
- Ensure web server can read the file (chmod 600 and correct ownership)
403 Forbidden errors
- For .env files: This is expected and correct (security protection)
- For PHP files: Check Apache/Nginx configuration allows PHP execution
- Verify .htaccess is not blocking legitimate requests
Installer redirects immediately
- Config file already exists - use the main application
- To reconfigure, delete or rename existing config.env
📚 Advanced Features
Paused Device Control
Control visibility of paused monitors:
- Default: Paused monitors are hidden
- Show Paused: Display paused monitors with warning indicators
- Toggle Button: Quick show/hide via UI button
- URL Override: ?showPausedDevices=true or false
When shown, paused monitors:
- Display "PAUSED" status with ⏸️ icon
- Use warning (yellow/orange) color
- Are counted separately in the header
- Don't trigger the red "issues" background
Query String Parameters
All configuration options can be overridden via URL (when ALLOW_QUERY_OVERRIDE=true):

Auto-Refresh on Config Changes