Skip to main content

Configuration

Email​

To send emails, you will have to configure the email driver. This is necessary for inviting new users to your workspace.
Docmost supports both SMTP and Postmark email drivers.

Using SMTP​

MAIL_DRIVER=smtp
SMTP_HOST=
SMTP_PORT=
SMTP_USERNAME=
SMTP_PASSWORD=
SMTP_SECURE=
MAIL_FROM_ADDRESS=hello@example.com
MAIL_FROM_NAME=Docmost

Using Postmark:​

MAIL_DRIVER=postmark
POSTMARK_TOKEN=
MAIL_FROM_ADDRESS=hello@example.com
MAIL_FROM_NAME=Docmost

File Storage​

Docmost supports both local storage and S3-compatible storage drivers. The default driver is local storage.

STORAGE_DRIVER=local

Using S3-Compatible Storage​

If you wish to use an S3-compatible storage, you have to add the below environment variables:

STORAGE_DRIVER=s3
AWS_S3_ACCESS_KEY_ID=
AWS_S3_SECRET_ACCESS_KEY=
AWS_S3_REGION=
AWS_S3_BUCKET=
AWS_S3_ENDPOINT=
AWS_S3_FORCE_PATH_STYLE=

Being S3-compatible means Docmost can work with AWS S3, Backblaze, Wasabi, DigitalOcean Spaces, Minio, and other S3-compatible providers.

File upload size limit​

The maximum file size that can be uploaded on the editor.

FILE_UPLOAD_SIZE_LIMIT=100mb

File import size limit​

The maximum size limit for an import file.

FILE_IMPORT_SIZE_LIMIT=200mb

AI​

OpenAI / Azure OpenAI​

AI_DRIVER=openai
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxx
AI_EMBEDDING_MODEL=text-embedding-3-small
AI_COMPLETION_MODEL=gpt-4o-mini
# optional
OPENAI_API_URL=

Google Gemini​

AI_DRIVER=gemini
GEMINI_API_KEY=AIzaSyxxxxx
AI_EMBEDDING_MODEL=gemini-embedding-001
AI_COMPLETION_MODEL=gemini-2.5-flash

Ollama​

AI_DRIVER=ollama
OLLAMA_API_URL=http://localhost:11434
AI_EMBEDDING_MODEL=nomic-embed-text
AI_COMPLETION_MODEL=qwen2.5:7b

Telemetry​

We anonymously collect the active version, user count, page count, space and workspace count. To disable telemetry:

DISABLE_TELEMETRY=true

Refer to the Environment Variables to see all available environment variables.