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.
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. |
|
diff
Package diff implements helpers for comparing two filesystems.
|
Package diff implements helpers for comparing two filesystems. |
|
editor
Package editor encapsulates working with external text editor.
|
Package editor encapsulates working with external text editor. |
|
fshasher
Package fshasher computes a fingerprint for an FS tree for testing purposes
|
Package fshasher computes a fingerprint for an FS tree for testing purposes |
|
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. |
|
parallelwork
Package parallelwork implements pallel work queue with fixed number of workers that concurrently process and add work items to the queue.
|
Package parallelwork implements pallel work queue with fixed number of workers that concurrently process and add work items to the queue. |
|
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. |
|
scrubber
Package scrubber contains helpers that remove sensitive information from Go structs before it's presented to users.
|
Package scrubber contains helpers that remove sensitive information from Go structs before it's presented to users. |
|
server
Package server implements Kopia API server handlers.
|
Package server implements Kopia API server handlers. |
|
serverapi
Package serverapi contains GO types corresponding to Kopia server API.
|
Package serverapi contains GO types corresponding to Kopia server API. |
|
throttle
Package throttle implements helpers for throttling uploads and downloads.
|
Package throttle implements helpers for throttling uploads and downloads. |
|
units
Package units contains helpers to convert sizes to humand-readable strings.
|
Package units contains helpers to convert sizes to humand-readable strings. |
|
webdavmount
Package webdavmount implements webdav filesystem for serving snapshots.
|
Package webdavmount implements webdav filesystem for serving snapshots. |
|
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/sftp
Package sftp implements blob storage provided for SFTP/SSH.
|
Package sftp implements blob storage provided for SFTP/SSH. |
|
blob/sharded
Package sharded implements common support for sharded blob providers, such as filesystem or webdav.
|
Package sharded implements common support for sharded blob providers, such as filesystem or webdav. |
|
blob/webdav
Package webdav implements WebDAV-based Storage.
|
Package webdav implements WebDAV-based Storage. |
|
compression
Package compression manages compression algorithm implementations.
|
Package compression manages compression algorithm implementations. |
|
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. |
|
gc
Package gc implements garbage collection of contents that are no longer referenced through snapshots.
|
Package gc implements garbage collection of contents that are no longer referenced through snapshots. |
|
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. |