feat: switch from Docker Hub to GitHub Container Registry

🏴 Fighting the power! No more $15/month Docker Hub fees.

- Use ghcr.io/basicmachines-co/basic-memory for container images
- Native GitHub integration with GITHUB_TOKEN (no external secrets)
- Update all documentation and examples to use GHCR
- Remove Docker Hub description update step (not needed for GHCR)
- Completely free solution for public repositories

Docker users can now:
docker pull ghcr.io/basicmachines-co/basic-memory:latest

Author: phernandez

.github/workflows/docker.yml

@@ -7,8 +7,8 @@ on:
   workflow_dispatch:  # Allow manual triggering for testing
 
 env:
-  REGISTRY: docker.io
-  IMAGE_NAME: basicmachines/basic-memory
+  REGISTRY: ghcr.io
+  IMAGE_NAME: basicmachines-co/basic-memory
 
 jobs:
   docker:
@@ -28,12 +28,12 @@ jobs:
         with:
           platforms: linux/amd64,linux/arm64
 
-      - name: Log in to Docker Hub
+      - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
         with:
           registry: ${{ env.REGISTRY }}
-          username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Extract metadata
         id: meta
@@ -59,10 +59,3 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-      - name: Update Docker Hub description
-        uses: peter-evans/dockerhub-description@v4
-        with:
-          username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
-          repository: ${{ env.IMAGE_NAME }}
-          readme-filepath: ./docs/Docker.md

docker-compose.yml

@@ -6,7 +6,7 @@ version: '3.8'
 services:
   basic-memory:
     # Use pre-built image (recommended for most users)
-    image: basicmachines/basic-memory:latest
+    image: ghcr.io/basicmachines-co/basic-memory:latest
 
     # Uncomment to build locally instead:
     # build: .

docs/Docker.md

@@ -7,7 +7,7 @@ system. This is particularly useful for integrating with existing Dockerized MCP
 
 ### Option 1: Using Pre-built Images (Recommended)
 
-Basic Memory provides pre-built Docker images on Docker Hub that are automatically updated with each release.
+Basic Memory provides pre-built Docker images on GitHub Container Registry that are automatically updated with each release.
 
 1. **Use the official image directly:**
    ```bash
@@ -16,15 +16,15 @@ Basic Memory provides pre-built Docker images on Docker Hub that are automatical
      -p 8000:8000 \
      -v /path/to/your/obsidian-vault:/app/data:rw \
      -v basic-memory-config:/root/.basic-memory:rw \
-     basicmachines/basic-memory:latest
+     ghcr.io/basicmachines-co/basic-memory:latest
    ```
 
 2. **Or use Docker Compose with the pre-built image:**
    ```yaml
    version: '3.8'
    services:
      basic-memory:
-       image: basicmachines/basic-memory:latest
+       image: ghcr.io/basicmachines-co/basic-memory:latest
        container_name: basic-memory-server
        ports:
          - "8000:8000"
@@ -293,11 +293,11 @@ For Docker-specific issues:
 For general Basic Memory support, see the main [README](../README.md)
 and [documentation](https://memory.basicmachines.co/).
 
-## Docker Hub Images
+## GitHub Container Registry Images
 
 ### Available Images
 
-Pre-built Docker images are available on Docker Hub at [`basicmachines/basic-memory`](https://hub.docker.com/r/basicmachines/basic-memory).
+Pre-built Docker images are available on GitHub Container Registry at [`ghcr.io/basicmachines-co/basic-memory`](https://github.com/basicmachines-co/basic-memory/pkgs/container/basic-memory).
 
 **Supported architectures:**
 - `linux/amd64` (Intel/AMD x64)
@@ -314,8 +314,8 @@ Docker images are automatically built and published when new releases are tagged
 
 1. **Release Process:** When a git tag matching `v*` (e.g., `v0.13.8`) is pushed, the CI workflow automatically:
    - Builds multi-platform Docker images
-   - Pushes to Docker Hub with appropriate tags
-   - Updates the Docker Hub repository description
+   - Pushes to GitHub Container Registry with appropriate tags
+   - Uses native GitHub integration for seamless publishing
 
 2. **CI/CD Pipeline:** The Docker workflow includes:
    - Multi-platform builds (AMD64 and ARM64)
@@ -325,21 +325,10 @@ Docker images are automatically built and published when new releases are tagged
 
 ### Setup Requirements (For Maintainers)
 
-To set up Docker Hub integration for this repository:
+GitHub Container Registry integration is automatic for this repository:
 
-1. **Create Docker Hub Repository:**
-   - Repository name: `basicmachines/basic-memory`
-   - Set as public repository
+1. **No external setup required** - GHCR is natively integrated with GitHub
+2. **Automatic permissions** - Uses `GITHUB_TOKEN` with `packages: write` permission
+3. **Public by default** - Images are automatically public for public repositories
 
-2. **Configure GitHub Secrets:**
-   ```
-   DOCKER_USERNAME - Docker Hub username
-   DOCKER_PASSWORD - Docker Hub access token (not password)
-   ```
-
-3. **Generate Docker Hub Access Token:**
-   - Go to Docker Hub → Account Settings → Security
-   - Create new access token with Read/Write permissions
-   - Use this token as `DOCKER_PASSWORD` secret
-
-The Docker CI workflow (`.github/workflows/docker.yml`) will automatically handle the rest.
+The Docker CI workflow (`.github/workflows/docker.yml`) handles everything automatically when version tags are pushed.