Instance Settings

Instance settings control authentication, storage, and memo policies. Admins can update these settings in the app or via the Instance Settings API.

Common areas include:

• General access controls: user registration, password auth, username and nickname changes, week start day, and custom instance profile.
• Storage settings: database, local filesystem, or S3-compatible attachment storage, file path templates, and upload limits.
• Memo-related settings: content length limits, double-click editing, and allowed reaction values.
• Notification settings: SMTP email delivery, sender details, reply-to address, and the email test endpoint.
• AI settings: instance-level OpenAI or Gemini providers and speech-to-text transcription defaults.

Tag colors and content-blur rules are user settings in Memos 0.30 and later, not instance settings. See Tags.

Sensitive settings

Storage, notification, and AI settings can contain credentials. API responses do not return stored S3 secrets, SMTP passwords, or AI provider API keys in plaintext. When updating those settings, submit a new secret only when you intend to replace it.

Related API

• Get Instance Setting
• Batch Get Instance Settings
• Update Instance Setting
• Test Instance Email Setting