Configuration
Configure server behavior, storage, authentication, and environment variables.
Configure Memos around how your instance runs, where its data lives, and how people sign in. These pages explain startup options, declarative configuration files, database and attachment storage, and access controls.
Environment Variables
Set the listen address, port, data directory, database connection, and canonical instance URL.
Declarative Configuration
Describe identity providers, instance settings, and bootstrap admins in JSON files, then plan and apply them.
Database
Configure SQLite, MySQL, or PostgreSQL and understand the operational tradeoffs.
Storage
Choose where attachments live and manage named storage configurations for new and existing files.
Authentication
Configure password sign-in, SSO providers, and personal access tokens.
Security
Review HTTPS, credentials, sharing, and recovery as part of operating your instance.
Choose the question you need to answer
| If you want to know… | Start with… |
|---|---|
| How do I change the port, data path, or external URL? | Environment Variables |
| How do I keep settings under deployment or secret-manager control? | Declarative Configuration |
| Which database fits my deployment? | Database |
| Where should uploads be stored? | Storage |
| How do I set up SSO or authenticate an integration? | Authentication |
| What should I review before exposing the instance? | Security |
Configuration layers
Runtime flags and MEMOS_* environment variables control server startup. Instance settings manage policies and services through the UI or API. From 26.10, declarative configuration files can manage identity providers, instance settings, and bootstrap administrators instead: Memos applies them at startup or with memos config apply, and managed resources are read-only in the app.
In Memos 0.31, the ACCESS instance setting selects public or private access independently of MEMOS_INSTANCE_URL. Set the URL to the canonical external HTTP(S) address, including for private instances behind a proxy. Manage access in instance settings or in declarative configuration.
For the installation itself, start with Deploy. Once Memos is running, use Admin for ongoing instance and account management, and Reverse Proxy for HTTPS and forwarded headers.