|
2 | 2 | <p align="center"><strong>Stateless HTTP API to convert HTML to PDF</strong></p> |
3 | 3 | <p align="center"> |
4 | 4 | <a href="https://codecov.io/github/mormahr/pdf-service?branch=main"><img alt="codecov.io" src="https://codecov.io/github/mormahr/pdf-service/coverage.svg?branch=main"/></a> |
5 | | - <img alt="Docker Image Version" src="https://img.shields.io/docker/v/mormahr/pdf-service?sort=semver" /> |
6 | | - <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/mormahr/pdf-service" /> |
7 | | - <img alt="Docker Image Size" src="https://img.shields.io/docker/image-size/mormahr/pdf-service?sort=semver" /> |
| 5 | + <a href="https://hub.docker.com/r/mormahr/pdf-service"><img alt="Docker Image Version" src="https://img.shields.io/docker/v/mormahr/pdf-service?sort=semver" /></a> |
| 6 | + <a href="https://hub.docker.com/r/mormahr/pdf-service"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/mormahr/pdf-service" /></a> |
| 7 | + <a href="https://hub.docker.com/r/mormahr/pdf-service"><img alt="Docker Image Size" src="https://img.shields.io/docker/image-size/mormahr/pdf-service?sort=semver" /></a> |
8 | 8 | </p> |
9 | 9 |
|
10 | 10 | A dockerized HTTP service, that generates PDF files from HTML using [WeasyPrint][weasyprint]. |
@@ -87,21 +87,8 @@ We strongly recommend that you use a release version instead of `:edge`. |
87 | 87 | ### Licensing |
88 | 88 |
|
89 | 89 | The service code is licensed under the MIT license. WeasyPrint, the underlying PDF generator |
90 | | -library, is licensed under the BSD license. The prebuilt container image contains a variety of |
91 | | -licenses, including GPLv2 and GPLv3 code. |
92 | | - |
93 | | -Currently, the image also contains AGPLv3 code, through the use of poppler for visual integration |
94 | | -tests. Poppler is not involved in generating PDFs, it's just included for the integration testing |
95 | | -suite. I hope to remove the testing dependencies from the production image in the future. |
96 | | - |
97 | | -After consulting [an article][container-os-article-1] about GPL licensing in containers, I think |
98 | | -this should not cause issues for stacks that use this container image in a closed source context, |
99 | | -as long as the image is [not modified][stackoverflow-aGPL-modified]. If it is modified, you should |
100 | | -look further into licensing requirements, although adding fonts shouldn't be a problem. From |
101 | | -my understanding, the affero clause is not triggered here, since the user is not interacting with |
102 | | -poppler at all. |
103 | | - |
104 | | -This section is how I understood the licensing requirements and is not legal advice. |
| 90 | +library, is licensed under the BSD license. The prebuilt production container image contains a |
| 91 | +variety of licenses, including GPLv2 and GPLv3 code. |
105 | 92 |
|
106 | 93 | ### Security |
107 | 94 |
|
@@ -138,6 +125,18 @@ credentials you set up in the reverse proxy. |
138 | 125 | The service has a `/health` endpoint that will respond with a `200` status code if the service is |
139 | 126 | running. This endpoint is also configured as a docker [`HEALTHCHECK`][docker-healthcheck]. |
140 | 127 |
|
| 128 | +### Supported architectures |
| 129 | + |
| 130 | +The docker image supports the `linux/amd64` (regular Intel and AMD 64bit processors on x86_64), |
| 131 | +`linux/arm64` (Apple Silicon, AWS Graviton, etc.) and `linux/arm/v7` (Raspberry Pi) architectures. |
| 132 | +Image sizes and other information that varies between architectures is taken from the `linux/amd64` |
| 133 | +variant. |
| 134 | + |
| 135 | +If you need a different architecture, please open an issue with your use-case. |
| 136 | + |
| 137 | +Native Windows docker images are not supported. The linux image can be run on Windows using Docker |
| 138 | +Desktop. |
| 139 | + |
141 | 140 | ## Development |
142 | 141 |
|
143 | 142 | ### Setup the development environment |
|
0 commit comments