Skip to content

Commit 8c9ee14

Browse files
committed
update docs
Signed-off-by: scepter914 <scepter914@gmail.com>
1 parent 808d9eb commit 8c9ee14

1 file changed

Lines changed: 44 additions & 0 deletions

File tree

docs/docs_custom_transfer_agent.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,50 @@ Using a Custom Transfer Agent, you can operate these on AWS S3 and are free from
1111

1212
### Compare fee between GitHub Git LFS and AWS S3
1313

14+
(Information on 2025/12/01)
15+
16+
GitHub includes monthly download bandwidth and storage for Git LFS, depending on your plan:
17+
18+
- Free / Pro / Free for organizations: 10 GiB/month bandwidth + 10 GiB storage
19+
- Team / Enterprise Cloud: 250 GiB/month bandwidth + 250 GiB storage
20+
21+
Notes:
22+
23+
- Bandwidth resets monthly, but storage does not reset (it accumulates over time).
24+
- Downloads by GitHub Actions and collaborators also count against the repo owner’s LFS bandwidth.
25+
26+
If you exceed the included quota and have billing enabled:
27+
28+
- Storage: $0.07 per GiB-month
29+
- Download bandwidth: $0.0875 per GiB
30+
31+
Maximum LFS object size depends on the plan in GitHub-hosted LFS:
32+
33+
- Free / Pro: 2 GB
34+
- Team: 4 GB
35+
- Enterprise Cloud: 5 GB
36+
37+
By using custom transfer backend, you can replace to Amazon S3.
38+
39+
- Storage: about $0.023 per GB-month (first 50 TB tier)
40+
- Data transfer: first 100 GB/month free, then roughly $0.09 per GB
41+
42+
### Example use case
43+
44+
Assumptions:
45+
- Stored: 200 GiB
46+
- Downloaded per month: 1 TiB (≈ 1024 GiB)
47+
48+
- 1. GitHub Free + AWS S3
49+
- GitHub: $0
50+
- S3 storage: ~200 GB × $0.023 ≈ $4.60 / month (region may vary)
51+
- S3 egress: (1024 − 100) GB × $0.09 = $83.16 / month
52+
- Total ≈ $87.76 / month
53+
- 2. GitHub Enterprise Cloud + GitHub-hosted LFS
54+
- GitHub Enterprise Cloud: $21 × N users / month
55+
- Overage bandwidth: (1024 − 250) GiB × $0.0875 = $67.73 / month
56+
- Total ≈ ($21 × N) + $67.73 / month
57+
1458
## Get started
1559
### Install
1660

0 commit comments

Comments
 (0)