Skip to main content

SECS

Simple Encrypted Container Setup (SECS) is based on Linux Unified Key Setup (LUKS). Because good Linux Unified Key Setups mean great Simple Encrypted Container Setups.

Purpose

If you are unfamiliar with LUKS encryption, it is most commonly used to encrypt entire disk partitions on Linux. However, it is also capable of encrypting files which can be mounted as a loop device, allowing you to create portable encrypted containers to keep different types of sensitive data isolated.

This script is a wrapper to simplify the steps required to create and use these containers.

Installation

SECS can be installed using pip.

$ sudo pip install secs
# or
$ pip install --user secs

Either command will install a script called secs which provides all the functionality.

SECS requires root access to run. Note that if you use the second install option, you will likely have to use sudo -E so that Python can find the package.

You may find it convenient to use a simple script like the bash script included in the repo to call sudo for you.

Examples

Root access (e.g. via sudo) is required for all commands.

Create a container. The number is the size in megabytes.

$ sudo secs create work_stuff 100
...
$ ls -Ap
work_stuff

Open a container. The default moves the container to .<container> and mounts to the container path. Use -m to set an explicit mount path.

$ sudo secs open work_stuff
...
$ ls -Ap
work_stuff/ .work_stuff

Close a container. The default unmounts from the container path and moves the container back to it’s original path. -m to set the mount path is required if it was used when the container was opened.

$ sudo secs close work_stuff
...
$ ls -Ap
work_stuff

Expand a container. The number is the amount in megabytes to increase the size of the container by.

$ sudo secs expand work_stuff 10

Implementation

secs is written in Python and is based on the LUKS specification. It requires that cryptsetup be available. It is currently written to use ext4 as the container filesystem. As such, this script will likely only work on Linux systems.

There are no external Python dependencies. The script may be freely copied anywhere, as long as Python 2 or 3 is available.

Metadata

Release files for secs 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for secs 0.2.0
File Size Uploaded Provenance Actions
secs-0.2.0.tar.gz 5.2 kB Without provenance Details for secs-0.2.0.tar.gz

Release files / secs-0.2.0.tar.gz

Download URL secs-0.2.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2ead3ad83af43768754f2d756cd25edbb1eb1db69fc6e53dd0575e22ca1aadf5
BLAKE2b-256 checksum
How to use checksums
30518aabf76d54170c3e535574ecfcf695da1edb4715abecd60a2ce922a6914b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for secs 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page