Skip to content

Commit 254220c

Browse files
authored
Improve server specifications
#177
2 parents 79de7e0 + e23e2f8 commit 254220c

File tree

1 file changed

+26
-13
lines changed

1 file changed

+26
-13
lines changed

content/deployment/reference/server-specifications.md

Lines changed: 26 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,27 +5,40 @@ weight: 2
55

66
# Server specifications
77

8-
The minimum recommended server specifications are:
8+
The minimum server specifications are:
99

10-
- 2GB RAM
11-
- 1CPU @ 2GHz
12-
- 10GB storage
10+
- 2 GB RAM
11+
- 1 CPU @ 2GHz
12+
- 2 GB storage
1313

14-
Approximately 750MB of storage is required for the engine itself, with the remaining space allocated for data generated by the engine.
14+
Approximately 750 MB of storage is required for the engine itself, with the remaining space allocated for data generated by the engine. Storage capacity should be calculated based on the scope and expected lifetime of the collection.
1515

16-
## Storage growth
16+
## Storage
1717

18-
Storage requirements typically grow at a rate of less than 0.5MB per tracked terms per month on average. This growth rate varies depending on the type of service being tracked:
18+
Recommended storage: 10 GB, with resizable partitioning to enable growth over time.
1919

20-
- Very large online platforms with large legal teams and heavy layouts: ~1MB per terms per month
21-
- Standard collections: ~0.1-0.3MB per terms per month
20+
Storage usage typically grows at a rate of 0.5 MB per tracked terms per month on average for latin scripts. This growth rate varies depending on the type of service being tracked:
21+
22+
- Services with large legal teams and heavy website layouts: ~1 MB per terms per month
23+
- Smaller services: ~0.1-0.3 MB per terms per month
24+
25+
### Examples
26+
27+
- Tracking 5 very large social media platforms on their 5 most common terms types (such as Terms of Service, Privacy Policy, Trackers Policy, Developer Agreement, Community Guidelines) would require approximately 300 MB of additional storage per year.
28+
- Tracking a sample of 200 platforms on an average of 4 common terms types would require approximately 5 GB of additional storage per year.
2229

2330
## Operating system
2431

25-
Supported operating systems:
26-
- Ubuntu 20.04 or higher
27-
- Debian 11 or higher
32+
The Open Terms Archive engine is [continuously tested](https://github.com/OpenTermsArchive/engine/blob/main/.github/workflows/test.yml#L12-L15) and guaranteed to work on the following operating systems:
33+
34+
- Ubuntu 22.04
35+
- Debian 11
36+
- macOS 14
37+
- macOS 15
38+
- Windows Server 2022
39+
40+
Please [report](https://github.com/OpenTermsArchive/engine/issues/new) any incompatibility with more recent versions of these operating systems.
2841

2942
## Location
3043

31-
Servers should be physically located in geographic regions that align with the jurisdiction the collection targets to ensure to [obtain documents like a user would]({{< relref "concepts/design-principles#3-obtain-documents-like-a-user-would" >}}). This is crucial because some services deliver different versions of documents based on the location of the request, even when the documents are supposed to be identical.
44+
Servers must be physically located in geographic regions that belong to the jurisdiction the collection targets to ensure to [obtain documents like a user would]({{< relref "concepts/design-principles#3-obtain-documents-like-a-user-would" >}}). This is crucial because some services deliver different versions of documents based on the inferred location of the request, even when the documents are supposed to be identical and located at the same URL.

0 commit comments

Comments
 (0)