README
¶
Kopia
n.
Kopia is a simple, cross-platform tool for managing encrypted backups in the cloud. It provides fast, incremental backups, secure, client-side encryption and data deduplication.
Unlike other cloud backup solutions, the user in full control of backup storage and is responsible for purchasing one of the cloud storage products (such as Google Cloud Storage), which offer great durability and availability for your data.
NOTICE:
Kopia is still in early stages of development and is not ready for general use. The repository data format is subject to change, including backwards-incompatible changes. Use at your own risk.
Getting Started
See Documentation for more information.
Licensing
Kopia is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
Contribution Guidelines
Kopia is open source and contributions are welcome. For more information on how to contribute see the Contribution Guidelines.
Reporting Security Issues
If you find a security issue you'd like to disclose privately, please contact jaak@jkowalski.net or via direct message on Slack.
Disclaimer
Kopia is a personal project and is not affiliated with, supported or endorsed by Google.
Cryptography Notice
This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.
The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with symmetric algorithms. The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.
Documentation
¶
Overview ¶
Command-line tool for creating and accessing backups.
Usage:
$ kopia [<flags>] <subcommand> [<args> ...]
Use 'kopia help' to see more details.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package cli implements command-line commands for the Kopia.
|
Package cli implements command-line commands for the Kopia. |
|
examples
|
|
|
upload_download
Command repository_api demonstrates the use of Kopia's Repository API.
|
Command repository_api demonstrates the use of Kopia's Repository API. |
|
Package fs defines virtual filesystem abstractions.
|
Package fs defines virtual filesystem abstractions. |
|
cachefs
Package cachefs implements a wrapper that caches filesystem actions.
|
Package cachefs implements a wrapper that caches filesystem actions. |
|
ignorefs
Package ignorefs implements a wrapper that hides ignored files listed in '.kopiaignore' and in policies attached to directories.
|
Package ignorefs implements a wrapper that hides ignored files listed in '.kopiaignore' and in policies attached to directories. |
|
localfs
Package localfs implements virtual filesystem abstraction for a local filesystem.
|
Package localfs implements virtual filesystem abstraction for a local filesystem. |
|
loggingfs
Package loggingfs implements a wrapper that logs all filesystem actions.
|
Package loggingfs implements a wrapper that logs all filesystem actions. |
|
internal
|
|
|
blobtesting
Package blobtesting is used for testing BLOB storage implementations.
|
Package blobtesting is used for testing BLOB storage implementations. |
|
editor
Package editor encapsulates working with external text editor.
|
Package editor encapsulates working with external text editor. |
|
fusemount
Package fusemount implements FUSE filesystem nodes for mounting contents of filesystem stored in repository.
|
Package fusemount implements FUSE filesystem nodes for mounting contents of filesystem stored in repository. |
|
ignore
Package ignore implements ignoring files based on 'gitignore' syntax.
|
Package ignore implements ignoring files based on 'gitignore' syntax. |
|
kopialogging
Package kopialogging provides loggers for the rest of codebase.
|
Package kopialogging provides loggers for the rest of codebase. |
|
logfile
Package logfile manages log files.
|
Package logfile manages log files. |
|
mockfs
Package mockfs implements in-memory filesystem for testing.
|
Package mockfs implements in-memory filesystem for testing. |
|
ospath
Package ospath provides discovery of OS-dependent paths.
|
Package ospath provides discovery of OS-dependent paths. |
|
repologging
Package repologging provides loggers.
|
Package repologging provides loggers. |
|
repotesting
Package repotesting contains test utilities for working with repositories.
|
Package repotesting contains test utilities for working with repositories. |
|
retry
Package retry implements exponential retry policy.
|
Package retry implements exponential retry policy. |
|
Package repo implements content-addressable Repository on top of BLOB storage.
|
Package repo implements content-addressable Repository on top of BLOB storage. |
|
blob
Package blob implements simple storage of immutable, unstructured binary large objects (BLOBs).
|
Package blob implements simple storage of immutable, unstructured binary large objects (BLOBs). |
|
blob/filesystem
Package filesystem implements filesystem-based Storage.
|
Package filesystem implements filesystem-based Storage. |
|
blob/gcs
Package gcs implements Storage based on Google Cloud Storage bucket.
|
Package gcs implements Storage based on Google Cloud Storage bucket. |
|
blob/logging
Package logging implements wrapper around Storage that logs all activity.
|
Package logging implements wrapper around Storage that logs all activity. |
|
blob/providers
Package providers registers all storage providers that are included as part of Kopia.
|
Package providers registers all storage providers that are included as part of Kopia. |
|
blob/s3
Package s3 implements Storage based on an S3 bucket.
|
Package s3 implements Storage based on an S3 bucket. |
|
blob/webdav
Package webdav implements WebDAV-based Storage.
|
Package webdav implements WebDAV-based Storage. |
|
content
Package content implements repository support for content-addressable storage.
|
Package content implements repository support for content-addressable storage. |
|
manifest
Package manifest implements support for managing JSON-based manifests in repository.
|
Package manifest implements support for managing JSON-based manifests in repository. |
|
object
Package object implements repository support for content-addressable objects of arbitrary size.
|
Package object implements repository support for content-addressable objects of arbitrary size. |
|
site
|
|
|
Package snapshot manages metadata about snapshots stored in repository.
|
Package snapshot manages metadata about snapshots stored in repository. |
|
policy
Package policy implements management of snapshot policies.
|
Package policy implements management of snapshot policies. |
|
snapshotfs
Package snapshotfs implements virtual filesystem on top of snapshots in repo.Repository.
|
Package snapshotfs implements virtual filesystem on top of snapshots in repo.Repository. |
|
tests
|
|