ivatar-docker/README.md

ivatar / libravatar as docker image

This is ivatar as a docker image. The image is freshly built every month from the ivatar repository at git.linux-kernel.at.

I couldn't deeply test the image, so please use it with caution.

How to use this image

docker run --name ivatar -p 8080:8080 -d registry.gudd-it.de/bastian/ivatar-docker

Please be aware that this will not persist any data.

Environment Variables

Variable	Description	Default from config.py
SITE_NAME		libravatar
SECURE_BASE_URL		https://avatars.linux-kernel.at/avatar/
BASE_URL		http://avatars.linux-kernel.at/avatar/
EMAIL_BACKEND		-
IVATAR_MAILGUN_API_KEY		-
IVATAR_MAILGUN_SENDER_DOMAIN		-
SERVER_EMAIL		ivatar@mg.linux-kernel.at
DEFAULT_FROM_EMAIL		ivatar@mg.linux-kernel.at
MYSQL_DATABASE		-
MYSQL_USER		-
MYSQL_PASSWORD		-
POSTGRESQL_DATABASE		-
POSTGRESQL_USER		-
POSTGRESQL_PASSWORD		-

Gitea Actions CI/CD

This repository includes a Gitea Actions workflow that automatically builds and pushes the Docker image to your Gitea container registry.

Setup Instructions

1. Create a Personal Access Token:

   • Go to your Gitea instance: https://gitea.purpleraft.com/
   • Navigate to Settings → Applications → Generate New Token
   • Create a token with write:packages permission
   • Copy the token value

2. Add Repository Secret:

   • Go to your repository settings
   • Navigate to Secrets and Variables → Actions
   • Add a new secret named GITEA_TOKEN with your personal access token as the value

3. Enable Actions (if not already enabled):

   • Ensure Gitea Actions are enabled in your repository settings
   • The workflow will trigger on pushes to main/master branches and pull requests

Workflow Features

• Builds Docker image using Docker Buildx
• Pushes to gitea.purpleraft.com/{username}/{repository}
• Creates multiple tags: branch name, latest (for default branch), and commit SHA
• Uses GitHub Actions cache for faster builds
• Runs on pushes and pull requests

To Do

• Figure out where the pictures are stored
• Write some setup instructions