Skip to content

docs: add Let's Encrypt email configuration note#3118

Open
hamzainayat20 wants to merge 1 commit into
appwrite:mainfrom
hamzainayat20:doc-2698-add-email-certificate-note
Open

docs: add Let's Encrypt email configuration note#3118
hamzainayat20 wants to merge 1 commit into
appwrite:mainfrom
hamzainayat20:doc-2698-add-email-certificate-note

Conversation

@hamzainayat20

Copy link
Copy Markdown

What does this PR do?

Adds a note to the manual installation documentation explaining that the _APP_EMAIL_CERTIFICATE environment variable should be set before starting Appwrite when using Let's Encrypt.

Why?

Without this value, Let's Encrypt cannot issue SSL certificates. This note helps users avoid a common configuration issue during self-hosted installations.

Closes #2698

@greptile-apps

greptile-apps Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds Let's Encrypt guidance to the manual self-hosting installation page. The main change is:

  • An info box describing the certificate email configuration required before startup.

Confidence Score: 4/5

The certificate configuration note names an unused variable and needs correction before merging.

  • The singular _APP_EMAIL_CERTIFICATE setting is not recognized by the installation configuration.
  • Existing certificate configuration uses _APP_SYSTEM_SECURITY_EMAIL_ADDRESS for the issuance email.

src/routes/docs/advanced/self-hosting/installation/+page.markdoc

Important Files Changed

Filename Overview
src/routes/docs/advanced/self-hosting/installation/+page.markdoc Adds a Let's Encrypt setup note, but names an environment variable that the installation configuration does not use.

Fix All in Claude Code Fix All in Codex

Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
src/routes/docs/advanced/self-hosting/installation/+page.markdoc:142
**Certificate Email Variable Is Ignored**

The manual installation configuration does not recognize the singular `_APP_EMAIL_CERTIFICATE` name. An installer following this note will set an unused variable while the certificate email remains unchanged, so the note does not prevent the certificate issue it describes.

```suggestion
If you plan to use Let's Encrypt for SSL certificates, make sure the `_APP_SYSTEM_SECURITY_EMAIL_ADDRESS` environment variable in your `appwrite/.env` file is set to a valid email address before starting Appwrite.
```

Reviews (1): Last reviewed commit: "docs: add Let's Encrypt email configurat..." | Re-trigger Greptile

2. Edit the `.env` file to customize your installation. At minimum, update `_APP_OPENSSL_KEY_V1` and `_APP_EXECUTOR_SECRET` with unique secret values

{% info title="Let's Encrypt" %}
If you plan to use Let's Encrypt for SSL certificates, make sure the `_APP_EMAIL_CERTIFICATE` environment variable in your `appwrite/.env` file is set to a valid email address before starting Appwrite. Without this value, Let's Encrypt certificates cannot be issued.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Certificate Email Variable Is Ignored

The manual installation configuration does not recognize the singular _APP_EMAIL_CERTIFICATE name. An installer following this note will set an unused variable while the certificate email remains unchanged, so the note does not prevent the certificate issue it describes.

Suggested change
If you plan to use Let's Encrypt for SSL certificates, make sure the `_APP_EMAIL_CERTIFICATE` environment variable in your `appwrite/.env` file is set to a valid email address before starting Appwrite. Without this value, Let's Encrypt certificates cannot be issued.
If you plan to use Let's Encrypt for SSL certificates, make sure the `_APP_SYSTEM_SECURITY_EMAIL_ADDRESS` environment variable in your `appwrite/.env` file is set to a valid email address before starting Appwrite.
Prompt To Fix With AI
This is a comment left during a code review.
Path: src/routes/docs/advanced/self-hosting/installation/+page.markdoc
Line: 142

Comment:
**Certificate Email Variable Is Ignored**

The manual installation configuration does not recognize the singular `_APP_EMAIL_CERTIFICATE` name. An installer following this note will set an unused variable while the certificate email remains unchanged, so the note does not prevent the certificate issue it describes.

```suggestion
If you plan to use Let's Encrypt for SSL certificates, make sure the `_APP_SYSTEM_SECURITY_EMAIL_ADDRESS` environment variable in your `appwrite/.env` file is set to a valid email address before starting Appwrite.
```

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Let's Encrypt and Self Hosting => _APP_EMAIL_CERTIFICATE must be populated

1 participant