Add warning about S3 outages affecting form downloads - #2088
Open
gaurav-goswamii wants to merge 4 commits into
Open
Add warning about S3 outages affecting form downloads#2088gaurav-goswamii wants to merge 4 commits into
gaurav-goswamii wants to merge 4 commits into
Conversation
yanokwa
requested changes
Aug 14, 2026
yanokwa
left a comment
yanokwa
left a comment
Member
There was a problem hiding this comment.
Thanks for the PR. I think it would read better if slotted in as the second to last bullet.
- If S3-compatible storage goes down, Central will still accept submissions, but devices may not receive updates to forms with attachments, and integrations or dashboards that use attachments may fail.
- If you opt into S3-compatible storage, you must design a backup and restore strategy for that storage.
Contributor
Author
|
@yanokwa Thanks! I've moved the warning to the second-to-last bullet and updated the wording as suggested. |
lognaturel
requested changes
Sep 10, 2026
|
|
||
| - If S3-compatible storage goes down, Central will still accept submissions, but devices may not receive updates to forms with attachments, and integrations or dashboards that use attachments may fail. | ||
| - If you opt into S3-compatible storage, you must design a backup and restore strategy for that storage. | ||
| If you already have or plan to collect many files, storing them outside the main database can reduce database load and cost. It can also make it more practical to backup and restore the database. |
Member
There was a problem hiding this comment.
This explains why someone might want to opt into the functionality, it feels like it should be at the top as it was before.
| By default, Central stores form and submission attachments in its main database, but it can be configured to move these to an external object store. | ||
|
|
||
| - If S3-compatible storage goes down, Central will still accept submissions, but devices may not receive updates to forms with attachments, and integrations or dashboards that use attachments may fail. | ||
| - If you opt into S3-compatible storage, you must design a backup and restore strategy for that storage. |
Member
There was a problem hiding this comment.
This is already in the consideration list below. I think it works well where it is.
| By default, Central stores form and submission attachments in its main database, but it can be configured to move these to an external object store. If you already have or plan to collect many files, storing them outside the main database can reduce database load and cost. It can also make it more practical to backup and restore the database. | ||
| By default, Central stores form and submission attachments in its main database, but it can be configured to move these to an external object store. | ||
|
|
||
| - If S3-compatible storage goes down, Central will still accept submissions, but devices may not receive updates to forms with attachments, and integrations or dashboards that use attachments may fail. |
Member
There was a problem hiding this comment.
I would probably tend to add this bullet point to the consideration list below. Another alternative would be to style it here as a warning.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What is included in this PR?
Adds a warning to the S3 documentation explaining that an S3 outage can prevent devices from downloading new forms and attachments, even though Central can continue accepting submissions.
Fixes #2055