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 (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-08T18:36:17.000Z (4 months ago)
• Last Synced: 2024-10-13T12:02:07.680Z (2 months ago)
• Topics: docker, docker-images, notion, notion-integration
• Language: Python
• Homepage:
• Size: 1.02 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_AUTH_TOKEN=your_notion_token

      - NOTION_DATABASE_ID=your_database_id

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

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

    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 \

  --hostname your-hostname \

  -e NOTION_AUTH_TOKEN=your_notion_token \

  -e NOTION_DATABASE_ID=your_database_id \

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

  -e SYNC_INTERVAL=300 \

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

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

  skyfay/docker-to-notion:latest

```

## FAQ 💬

### Create your Database in Notion

Create a Notion Database and add the following columns:

![image](data/notion-props.png)

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

Type     | Name

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

Title    | Container Name

Text     | Server Name

Text     | Image

Text     | Current Tag

Text     | Current Version

Text     | New Version

Text     | Local Digest

Text     | Remote Digest

Checkbox | Needs Update

Checkbox | Newer Tag Available

### 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)