Docker/README.adoc

= Docker

This repository contains custom Dockerfiles whose images will be stored on this Gitea container registry.


== How to use

To use the container registry you must login using your credentials. If you have enabled two-factors authentication, you will need to create an application token with repository read access. More informations on https://docs.gitea.com/usage/packages/container[Gitea documentation].

[source,shell]
----
docker login git.syyrell.com
docker pull git.syyrell.com/{owner}/{image}:{tag}
docker push git.syyrell.com/{owner}/{image}:{tag}
----

== Dockerfiles available

=== caddy-duckdns.Dockerfile

Caddy base image with https://github.com/caddy-dns/duckdns[duckdns module] added. There is a `VERSION` variable (default: latest) to chose which Caddy version to use. There is also an ARM variant of this image link:./caddy-arm-duckdns.Dockerfile[here].

[source,shell]
----
docker build --build-arg VERSION=2.7.6 -f ./caddy-duckdns.Dockerfile -t caddy-duckdns:2.7.6 .
----

Existing pre-built images :

* git.syyrell.com/syrell/caddy-duckdns:2.7.6
* git.syyrell.com/syrell/caddy-arm-duckdns:2.7.6

=== gitea-external-renderers.Dockerfile

Gitea base image (rootless) with https://docs.gitea.com/administration/external-renderers[external renderers] added. There is a `VERSION` (default: latest) variable to chose which Gitea version to use. Libraries for Jupyter are not installed to keep the image size reasonable, other providers should work just fine. Don't forget to update your `app.ini` file to enable desired providers.

[source,shell]
----
docker build --build-arg VERSION=1.21.4 -f ./gitea-external-renderers.Dockerfile -t gitea-external-renderers:1.21.4 .
----

Existing pre-built images :

* git.syyrell.com/syrell/gitea-external-renderers:1.21.1
* git.syyrell.com/syrell/gitea-external-renderers:1.21.2
* git.syyrell.com/syrell/gitea-external-renderers:1.21.3
* git.syyrell.com/syrell/gitea-external-renderers:1.21.4