Skip to content

Commit a3ece61

Browse files
committed
docs: Add overview
1 parent af18542 commit a3ece61

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

README.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,15 @@ Simple Tape File System (STFS), a file system for tapes and tar files.
1212

1313
## Overview
1414

15-
🚧 This project is a work-in-progress! Instructions will be added as soon as it is usable. 🚧
15+
STFS is a filesystem that brings tapes and tar files into the 21st century.
16+
17+
It enables you too ...
18+
19+
- **Use a tape or tar file like a regular disk**: STFS uses the robust `tar` format and tape technology to provide a fully features filesystem. This makes such storage solutions much for accessible and manageable, while also significantly increasing the performance of everyday operations such as listing and searching for files by using a SQLite-based on-disk index.
20+
- **Archive data securely**: The integrated transparent, asymmetrical encryption and signature support makes it possible to use almost any tape as a regulations compliant storage medium, while still being able to take advantage of all the benefits of tapes like reduced cost and increased reliability.
21+
- **Compress data efficiently**: By leveraging the embedded compression functionality, it is possible to store even more data on tapes without sacrificing the user experience.
22+
- **Recover data in unexpected scenarios**: Even if sudden power drops happen, the drive fails, the index gets corrupted or STFS stops being maintained, your data is secure. Because it is based on open standards such as `tar`, SQLite, `zstandard`, PGP and others, it is possible to extract your data even if STFS's integrated recovery tools don't suffice.
23+
- **Build your own storage solution**: In addition to its own, optimized APIs, STFS provides a [`afero.FS implementation`](https://github.com/spf13/afero). This makes embedding STFS and accessing files on a tape or in a tar file through Go easy.
1624

1725
## Installation
1826

@@ -23,7 +31,6 @@ On Linux, you can install them like so:
2331
```shell
2432
$ curl -L -o /tmp/stfs "https://github.com/pojntfx/stfs/releases/latest/download/stfs.linux-$(uname -m)"
2533
$ sudo install /tmp/stfs /usr/local/bin
26-
$ sudo setcap cap_net_admin+ep /usr/local/bin/stfs # This allows rootless execution
2734
```
2835

2936
On macOS, you can use the following:

0 commit comments

Comments
 (0)