Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.teable.ai/llms.txt

Use this file to discover all available pages before exploring further.

Available for self-hosted Business plan and above
Path: Admin Panel → Instance Settings The Instance Settings page is used to manage the core settings of the whole instance, including General Settings, Email, and the system checks shown in the Pending configuration panel.

Overview

This page mainly covers instance-level basics. The main settings are grouped as follows:
Setting typeDescription
General SettingsIncludes Allow creating new accounts, Allow sending space invitations, Allow everyone to create new spaces, and Enable email verification
EmailIncludes Notification Email and Automation Email for password reset, email verification, notification emails, and invitation emails
To enable system emails, complete the setup in Email.
If email is not fully configured, the Email item in the Pending configuration panel will not turn green.

Pending configuration

The Pending configuration panel on the right is a system checklist. It shows which important settings are still missing for the instance. Common checks on this page include:
ItemImpact
PUBLIC_ORIGIN environment variableAffects features that rely on an external access URL, such as attachments and imports
Enable HTTPSAffects capabilities that rely on HTTPS, such as copy and paste
EmailAffects password reset, email verification, notifications, and similar features
If these items are not completed, the instance may still open normally, but some features can remain unavailable.

Relationship to AI Settings

Instance Settings shows part of the system-level checks, but it is not where you configure AI models, the AI Chat runtime, or App Builder. Go here for those settings: You can think of the split like this:
  • Instance Settings: Covers the core capabilities of the instance itself
  • AI Settings: Covers AI Chat, AI fields, AI automation, and App Builder

Check order

If you are preparing a new self-hosted deployment or going live for the first time, check these items in order:
1

Check the access URL

Make sure PUBLIC_ORIGIN is configured correctly.
2

Check HTTPS

Make sure the instance already has HTTPS enabled.
3

Check email

Make sure SMTP is configured and can send emails successfully.
4

Continue with AI Settings

After the basic items are confirmed, continue with AI Settings.
This makes it easier to turn the Pending configuration items green in order and helps with troubleshooting.

FAQ

This usually means the instance is reachable, but one or more important runtime requirements are still missing. Follow the prompts in the right-side panel and complete them one by one instead of relying only on whether the page opens.
Check whether the saved SMTP settings are complete, whether they match the intended sending purpose, and whether verification or notification emails can be sent reliably.
Many features that rely on an external access URL depend on it. If the configured value does not match the actual access URL, features such as imports, attachments, or redirects may not work correctly.
Last modified on May 4, 2026