# Podcastrr - Forgejo Integration Changes

This document summarizes the changes made to integrate Podcastrr with Forgejo for CI/CD and container registry functionality.

## Files Created

1. **`.drone.yml`**
   - CI/CD pipeline configuration for Forgejo
   - Includes steps for testing, building Docker images, and notifications
   - Automatically builds and pushes Docker images on pushes to the main branch

2. **`README_FORGEJO.md`**
   - Comprehensive guide for setting up and using Podcastrr with Forgejo
   - Includes instructions for repository setup, secrets configuration, and using the Docker image

3. **`docker-compose.override.yml.example`**
   - Template for local customization of Docker Compose setup
   - Provides examples for development-specific settings

## Files Updated

1. **`.gitignore`**
   - Added Docker-specific entries
   - Added common Python patterns

2. **`.env.example`**
   - Updated for Docker compatibility (Linux-style paths)
   - Added Forgejo-specific configuration variables
   - Set production as the default environment

3. **`docker-compose.yml`**
   - Made it more flexible for Forgejo integration
   - Added environment variable interpolation with defaults
   - Added commented options for using Forgejo registry

## Next Steps

1. **Set up your Forgejo repository**
   - Follow the instructions in `README_FORGEJO.md`

2. **Configure CI/CD secrets**
   - Add the required secrets to your Forgejo repository settings

3. **Customize for your environment**
   - Copy `.env.example` to `.env` and update with your settings
   - Copy `docker-compose.override.yml.example` to `docker-compose.override.yml` for local customization

4. **Push to Forgejo**
   - The CI/CD pipeline will automatically build and push your Docker image

5. **Pull and run the Docker image**
   - Use the commands in `README_FORGEJO.md` to pull and run your Docker image

## Additional Information

- The Docker image is built using the existing Dockerfile, which was already well-configured
- The CI/CD pipeline includes testing to ensure code quality
- The Docker Compose setup allows for both local development and production deployment