Skip to main content

A Linux FUSE filesystem that signs files on write using GPG (PKI), ideal for nano-data pipelines.

Project description

nanosignfs

nanosignfs is a Linux-based virtual filesystem built on FUSE (Filesystem in Userspace) that seamlessly integrates cryptographic file signing into everyday write operations. Each time a file is written or modified within the mounted filesystem, it is automatically signed using a pre-configured GPG key, producing a detached .sig signature file. This mechanism ensures end-to-end integrity and non-repudiation, allowing downstream systems or auditors to verify that the content has not been tampered with. The system is particularly suited for nano-data pipelines—such as those found in scientific research, IoT, or regulated environments where even small files require cryptographic assurance. By decoupling signature logic from application logic and embedding it directly into the filesystem layer, nanosignfs simplifies compliance workflows and enhances trust in data provenance without burdening the end user.


Key Features

  • Transparent FUSE mount backed by local storage
  • Automatic file signing using a GPG key on each write
  • Detached .sig signature files created per file
  • Verifiable audit trail with GPG-based cryptographic integrity
  • Lightweight and secure – ideal for nano-data, research pipelines, and compliance workflows

Installation

Prerequisites

  • Before using nanosignfs, make sure your system meets the following requirements:
  • Operating System: Linux (with FUSE support)
  • Python: 3.7+

System Packages:

  • fuse – FUSE userspace filesystem library
  • gpg – GnuPG for digital signing

Install system dependencies

  • sudo yum update
  • sudo yum install fuse gpg
  • sudo modprobe fuse

Author

Raghava Chellu raghava.chellu@gmail.com

Clone the repository

git clone https://github.com/RaghavaCh440/nanosignfs.git cd nanosignfs

License

MIT License

Copyright (c) 2025 Raghava Chellu

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nanosignfs-0.1.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nanosignfs-0.1.0-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file nanosignfs-0.1.0.tar.gz.

File metadata

  • Download URL: nanosignfs-0.1.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.18

File hashes

Hashes for nanosignfs-0.1.0.tar.gz
Algorithm Hash digest
SHA256 bd8dd922b610e4523e61949110797c0df239bcd4f072d87a412b7437c6c6b232
MD5 3ba81125e4d52c55f883bb0a82b4e0d9
BLAKE2b-256 e8daee6240dfe5166aa6ba5aed53d9aae59e0bc92dde2db459f7db7bc6272ea0

See more details on using hashes here.

File details

Details for the file nanosignfs-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: nanosignfs-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.18

File hashes

Hashes for nanosignfs-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e7fd9a3f39dd3d832da2966a1abf86162d64d4b7acaf1758cc90bdb2af1d3338
MD5 5c6953ea7d9422e9d48afeb7eb2358a4
BLAKE2b-256 b1495636a5450491ccc5ab7f7417630354413ba985599c8601b8de088cf7ea86

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page