https://github.com/skyfay/docker-to-notion

This software checks which Docker images are used on the system, checks for updates and sends the information to a Notion database.
https://github.com/skyfay/docker-to-notion

docker docker-images notion notion-integration

Last synced: about 1 month ago
JSON representation

This software checks which Docker images are used on the system, checks for updates and sends the information to a Notion database.

• Host: GitHub
• URL: https://github.com/skyfay/docker-to-notion
• Owner: Skyfay
• License: mit
• Created: 2024-08-26T18:05:17.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-03-20T21:25:04.000Z (3 months ago)
• Last Synced: 2025-05-09T22:34:41.830Z (about 2 months ago)
• Topics: docker, docker-images, notion, notion-integration
• Language: Python
• Homepage:
• Size: 1.36 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Docker to Notion

![preview](data/preview.png)

![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/tag/Skyfay/Docker-to-Notion?label=Version)

![GitHub (Pre-)Release Date](https://img.shields.io/github/release-date-pre/Skyfay/Docker-To-Notion)

![GitHub contributors](https://img.shields.io/github/contributors/Skyfay/Docker-to-Notion)

![GitHub commit activity (branch)](https://img.shields.io/github/commit-activity/t/Skyfay/Docker-to-Notion)

![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Skyfay/Docker-to-Notion)

![Docker Pulls](https://img.shields.io/docker/pulls/skyfay/docker-to-notion)

![Discord](https://img.shields.io/discord/580801656707350529?label=Discord&color=%235865f2&link=https%3A%2F%2Fdiscord.com%2Finvite%2FYvgPyky)

![GitHub](https://img.shields.io/github/license/Skyfay/Docker-to-Notion)

Docker image updates visualized and centralized in Notion.

## Features ✨

- Get Images from the Docker Socket and send Updates to Notion

- Exclude Images

- Set a specific sync interval

## Usage 🐳

Via Docker Compose:

```yaml

version: '3.8'

services:

  app:

    image: skyfay/docker-to-notion:latest

    container_name: docker-to-notion

    hostname: your-hostname # Not needed if you use linux and /etc/hostname

    environment:

      - NOTION_API_KEY=your_notion_api_key

      - NOTION_DATABASE_ID=your_database_id

      - EXCLUDED_IMAGES=["skyfay/docker-to-notion"] # [] = exclude no images, ["image", "image2"] = exclude multiple images

      - SYNC_INTERVAL=3600  # the lowest value is 300 / 5 minutes

      # If you have images github container registry (ghcr)

      - GITHUB_TOKEN=your_github_token # https://github.com/settings/tokens only need read:packages permission

      # If you have images with aws container registry (ecr)

      - AWS_ACCESS_KEY=your_aws_access_key

      - AWS_SECRET_KEY=your_aws_secret_key

      - AWS_REGION='eu-central-1'

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock

      - /etc/hostname:/etc/hostname:ro # Linux only instead use docker hostname above

    restart: unless-stopped

```

Via Docker CLI:

```bash

docker run -it --rm \

  --name docker-to-notion \

  -v /var/run/docker.sock:/var/run/docker.sock \

  -v /etc/hostname:/etc/hostname:ro \

  -e NOTION_API_KEY="your_notion_api_key" \

  -e NOTION_DATABASE_ID="your_database_id" \

  -e CHECK_INTERVAL=3600 \

  -e GITHUB_TOKEN="your_github_token" \

  -e EXCLUDED_IMAGES='["skyfay/docker-to-notion"]' \

  skyfay/docker-to-notion:latest

```

## FAQ 💬

### Create your Database in Notion

Create a Notion Database and add the following columns:

Type     | Name

-------- | -------------------

Title    | Repository

Text     | Server

Text     | Tag

Text     | Registry

Text     | Image ID

Text     | Size

Text     | Update available

It doesn't matter in which order, but the names and types must match exactly.

I recommend optionally adding “Last edited time” by Notion.

### How to get your Notion token?

First of all go to your Notion intigrations: 

1. Create a new intigration ![image](data/notion-integration_new.png)

2. Add a intigration name, select your workspace and save ![image](data/notion-integration_create.png)

3. Go to the intigration and copy your Notion Token = Internal Integration Secret ![image](data/notion-integration_secret.png)

### How to get the Notion database ID

Visit Notion via Web Browser: 

1. Go to your Database and open it full screen and copy the database ID from your WEB URL ![image](data/notion-db_id.png)

2. Add the intigration you created to the notion database to give access ![image](data/notions-connect.png)