https://github.com/ryanfleck/config-file-host

Flask app to host a single file from the filesystem with protection.
https://github.com/ryanfleck/config-file-host

Last synced: 6 days ago
JSON representation

Flask app to host a single file from the filesystem with protection.

• Host: GitHub
• URL: https://github.com/ryanfleck/config-file-host
• Owner: RyanFleck
• License: gpl-3.0
• Created: 2026-05-26T17:37:22.000Z (13 days ago)
• Default Branch: master
• Last Pushed: 2026-05-26T18:17:48.000Z (13 days ago)
• Last Synced: 2026-05-26T20:12:43.422Z (13 days ago)
• Language: Python
• Size: 30.3 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Config File Host

![Python 3.13](https://img.shields.io/badge/Python-3.13-blue?logo=python&logoColor=CCC)

[![Python Lint & Test](https://github.com/RyanFleck/Config-File-Host/actions/workflows/python-test.yml/badge.svg?branch=master)](https://github.com/RyanFleck/Config-File-Host/actions/workflows/python-test.yml)

[![Docker Image CI](https://github.com/RyanFleck/Config-File-Host/actions/workflows/docker-image.yml/badge.svg?branch=master)](https://github.com/RyanFleck/Config-File-Host/actions/workflows/docker-image.yml)

Flask app to host a single file from the filesystem with basic protections.

## Improvements

1. 100mb running size just to serve one file? Unreal. Fix.

1. Add Redis or a better backend for rate limiting.

## Test

```

uv run pytest

```

## Build

```

docker build -t config-file-host .

```

## Run

It is recommended to add a docker-compose file to deploy this app.

```bash

# docker-compose.yml

services:

  configfileservice:

    build:

      context: .

      dockerfile: Dockerfile

    container_name: secretfile

    ports:

      - "8809:8000"

    env_file:

      - .env

    # Optional: only needed if PROTECTED_FILE points to a host file

    volumes:

      - /your/folder/for/export:/data/export:ro

    restart: unless-stopped

    labels:

      - "traefik.enable=true"

      # ...other Traefik config

    networks:

      - web

networks:

  web:

    external: true

# .env

DOWNLOAD_PATH=calendar

DOWNLOAD_KEY=strong

PROTECTED_FILE=/data/export/your-file.txt

```