Browse documentation

🧭 Start Here

Blackcap Overview ✨ Blackcap Feature Catalog Installation First Run

🚀 Deploy Blackcap

Platform Stacks and Raspberry Pi Hardware Raspberry Pi Deployment Raspberry Pi Client Services GCP Deployment Application Updates Environment Variables and Secrets Reverse Proxy and TLS Background Jobs and Schedules

🛠️ Administer Blackcap

Organizations Users, Permissions, and Authentication Configuration Workspace Backups and Restore Database Administration Regression Testing Performance and Job Status Audit, Access Activity, and Logging GeoIP and Access Location Data Retention and Purge Support Requests API Tester and Postman Instance Reporting

🍽️ Use Recipes

Recipes and the Recipe Library Recipe Import and Discovery Recipe Editing and Cache Artifacts Recipe Sharing Social Recipe Import AI Recipe Image Generation

📅 Plan Meals

🛒 Use Shopping Lists

Shopping Lists and Shop a List External and Household Shopping 🧩 Chrome Extension Shop With

🧺 Manage Kitchen Inventory

🧺 Kitchen Inventory

🖥️ Use Displays

Displays and Connections Assigning and Scheduling Display Content Remote Pi Client E-Ink Rendering Menu Refresh and Rendering Noun Project Footer Images

🧑‍🍳 Cook with Let’s Cook

🧑‍🍳 Let’s Cook 🧑‍🍳 Let’s Cook Controls and Timers

🤖 Use and Administer AI

🤖 AI in Blackcap 🤖 AI Providers and Connections 🤖 AI Seeds and Usage

🧩 Use the Chrome Extension

🧩 Blackcap Chrome Extension 🧩 Chrome Extension Recipe Capture 🧩 Chrome Extension Shop With 🧩 Chrome Extension Release and Privacy

🎮 Play Games

🎮 Games and Trivia

🔌 Integrations

Email Integration Cloud Storage Integrations Voice Assistants Shop With Integrations Authentication Providers

⚙️ Develop Blackcap

Application Architecture Database Service and Data Access SQLite and PostgreSQL Database Migrations Background Job Architecture Testing API Architecture Security and Organization Scoping UI, Icons, and Documentation Assets Blackcap-Safe Emoji Documentation Standards Terminology

⚠️ Troubleshoot Blackcap

⚠️ Troubleshooting Deployment Troubleshooting Display Troubleshooting Recipe Import Troubleshooting 🤖 AI Troubleshooting Backup Troubleshooting Database Troubleshooting Diagnostic Organization Clones Support Requests

⚠️ Troubleshooting

Audience: User, Org Admin, System Admin, Deployment Administrator, Developer, Support
Related: Deployment · Displays · Recipe Import · AI · Backups · Database · Diagnostic Clones · Performance and Job Status · Support Requests

Start with the feature-specific page, then check Job Status, Performance, logs, database health, deployment services, and the relevant Active Organization context. Preserve the exact user-visible error and safe organization/display/job context without copying credentials, API Tokens, provider tokens, private URLs, or sensitive form values.

🧪 Reproduce safely with a Diagnostic Clone

Use a Diagnostic Clone when support needs to reproduce an organization-specific problem without changing the source organization. The clone can copy selected safe configuration and current operational data into an isolated regression organization, where troubleshooting, validation, and destructive test actions cannot affect the organization experiencing the issue.

🆘 Create a Support Request

When platform support is configured, authenticated Admin and Mobile users can choose Support Request from the Blackcap account menu. See Support Requests for the submission workflow, configuration requirements, captured safe diagnostic context, optional image handling, rate limits, case numbering, email recipients, privacy protections, and audit history.

On this page