MemosConfiguration
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, deployment-managed settings, database and attachment storage, and access controls.
Environment Variables
Set the listen address, port, data directory, database connection, and canonical instance URL.
Deployment-Managed Configuration
Load selected instance settings and identity providers from mounted JSON files at startup.
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? | Deployment-Managed 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. When a supported setting is supplied by a deployment-managed file, that file is authoritative for the server process; changes to it require a restart.
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 a deployment-managed access file.
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.