{"id":20550208,"url":"https://github.com/dnmfarrell/stasis","last_synced_at":"2025-04-14T11:15:46.509Z","repository":{"id":149704072,"uuid":"40798578","full_name":"dnmfarrell/Stasis","owner":"dnmfarrell","description":"an encrypting archive tool using tar, gpg and perl","archived":false,"fork":false,"pushed_at":"2019-12-20T18:17:51.000Z","size":23,"stargazers_count":14,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2023-10-20T19:24:18.708Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://perltricks.com/article/185/2015/8/27/Simple--secure-backups-with-Perl/","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dnmfarrell.png","metadata":{"files":{"readme":"README.pod","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-08-16T04:16:49.000Z","updated_at":"2022-11-05T08:34:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"a229203f-0c39-4c69-b2f3-575a3fec188d","html_url":"https://github.com/dnmfarrell/Stasis","commit_stats":null,"previous_names":[],"tags_count":1,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnmfarrell%2FStasis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnmfarrell%2FStasis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnmfarrell%2FStasis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnmfarrell%2FStasis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dnmfarrell","download_url":"https://codeload.github.com/dnmfarrell/Stasis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224867755,"owners_count":17383088,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T02:23:49.904Z","updated_at":"2024-11-16T02:23:51.968Z","avatar_url":"https://github.com/dnmfarrell.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"=head1 NAME\n\nstasis - an encrypting archive tool using tar, gpg and perl\n\n=head1 SYNOPSIS\n\n  stasis [options]\n\n  Options:\n\n      --destination -de destination directory to save the encrypted archive to\n      --days        -da only create an archive if one doesn't exist within this many days (optional)\n      --files       -f  filepath to a text file of filepaths to backup\n      --ignore      -i  filepath to a text file of glob patterns to ignore (optional)\n      --limit       -l  limit number of stasis backups to keep in destination directory (optional)\n      --passphrase      passphrase to use\n      --passfile        filepath to a textfile containing the password to use\n      --referrer    -r  name of the gpg key to use (instead of a passphrase or passfile)\n      --temp        -t  temp directory path, uses /tmp by default\n      --verbose     -v  verbose, print progress statements (optional)\n      --help        -h  print this documentation (optional)\n\n=head1 OPTIONS\n\n=head2 Examples\n\nSave all the files listed in C\u003cfiles_to_backup.txt\u003e (one per line) to Dropbox:\n\n  $ stasis --destination ~/Dropbox --files files_to_backup.txt --passphrase mysecretkey\n  $ stasis -de ~/Dropbox -f files_to_backup.txt --passphrase mysecretkey\n\nUse passfile instead of passphrase\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt --passfile /path/to/passfile\n\nUse referrer GPG key to encrypt\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt -r keyname@example.com\n\nIgnore the files matching patterns in C\u003c.stasisignore\u003e\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt -r keyname@example.com -i .stasisignore\n\nVerbose mode\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt -r mygpgkey@email.com -v\n\nOnly keep the last 4 backups\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt --passphrase mysecretkey -l 4\n\nOnly make weekly backups\n\n  $ stasis -de ~/Dropbox -f files_to_backup.txt --passphrase mysecretkey --days 7\n\n=head1 REQUIREMENTS/DEPENDENCIES\n\n=over 4\n\n=item * GnuPG\n\n=item * GNU tar\n\n=item * Perl\n\n=back\n\nC\u003cstasis\u003e has been tested on Linux with GNU tar v 1.28, GnuPG v1.4.19 and Perl 5.20.2. It should work on many earlier versions too.\n\n=head1 BUGS/LIMITATIONS\n\nIf C\u003c--files\u003e contains the temp or destination location in it, C\u003ctar\u003e will create an infinite loop.\n\nWhen a passphrase or file is provided, symmetric GPG encryption is done using AES256 cipher algorithm. At the time of development\nthis is considered secure, but only as strong as the passphrase used to encrypt the data.\n\n=head1 INSTALLATION\n\n  $ cpan stasis\n\nOr\n\n  $ git clone https://github.com/dnmfarrell/Stasis\n  $ cd Stasis\n  $ perl Makefile.PL\n  $ make\n  $ make install\n\n=head1 REPOSITORY\n\nL\u003chttps://github.com/dnmfarrell/Stasis\u003e\n\n=head1 AUTHOR\n\nDavid Farrell E\u003ccopy\u003e 2015\n\n=head1 LICENSE\n\nFreeBSD (2 clause BSD license)\n\n\n=cut\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnmfarrell%2Fstasis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdnmfarrell%2Fstasis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnmfarrell%2Fstasis/lists"}