[{"_1":2,"_169":-5,"_170":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_144":145},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":11,"_141":-5,"_142":143},"canonicalUrl","https://hub.docker.com/r/svendowideit/dat/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","svendowideit","reponame","dat","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2018-03-02T03:18:54.462632Z","description","prototype dat image","is_private","last_updated","2018-03-03T04:40:36.145808Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",4368,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Dat\n\n> npm install -g dat\n\nA distributed data community.\nDat is a nonprofit-backed community & open protocol for building apps of the future.\n\nUse Dat command line to share files with version control, back up data to servers, browse remote files on demand, and automate long-term data preservation.\n\n[

][Dat Project]\n\nHave questions? Join our chat via IRC or Gitter:\n\n[![#dat IRC channel on freenode][irc-badge]][irc-channel]\n[![datproject/discussions][gitter-badge]][gitter-chat]\n\n### Table of Contents\n\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Using Dat](#usage)\n- [Using Dat from Docker](#dockerusage)\n- [Troubleshooting](#troubleshooting)\n- [Javascript API](#js-api)\n- [For Developers](#for-developers)\n\n#### What is Dat?\n\nShare, backup, and publish your filesystem. You can turn any folder on your computer into a dat. Dat scans your folder, allowing you to:\n\n* Track your files with automatic version history.\n* Share files with others over a secure peer to peer network.\n* Automate live backups to external HDs or remote servers.\n* Publish and share files with built in HTTP server.\n\nDat allows you to focus on the fun work without worrying about moving files around. **Secure**, **distributed**, **fast**.\n\n* Documentation: [docs.datproject.org](https://docs.datproject.org)\n* [DatBase](https://datbase.org)\n* [Dat white paper]\n\n##### Other Applications\n\nRather not use the command line? Check out these options:\n\n* [Dat Desktop] - A desktop app to manage multiple dats on your desktop machine.\n* [Beaker Browser] - An experimental p2p browser with built-in support for the Dat protocol.\n\n## dat command line\n\nShare, download, and backup files with the command line! Automatically sync changes to datasets. Never worry about manually transferring files again.\n\nMac/Linux | Windows | Version\n-------------- | ------------ | ------------\n[![Travis][travis-badge]][travis-build] | [![Build status][appveyor-badge]][appveyor-build] | [![NPM version][npm-badge]][npm-package]\n\nHave questions or need some guidance?\nYou can [chat with us](http://chat.datproject.org) in IRC on [#dat][irc-channel] or [Gitter][gitter-chat]!\n\n## Installation\n\nDat can be used as a command line tool or a javascript library:\n\n* `npm install -g dat` - Install `dat` globally to use in the command line.\n* [require('dat')][dat-node] - dat-node, a library for downloading and sharing dat archives in javascript apps.\n\n### Installing via npm\n\nThe Dat command line tool can be installed with `npm`:\n\n```\nnpm install -g dat\n```\n\nMake sure you have `node` and `npm` installed first. If not, see the prerequisites section below.\n\nOnce `npm install` finishes, you should be able to run the `dat` command. If not, see the [installation troubleshooting](#troubleshooting) for tips.\n\n#### Prerequisites\n\n* **Node**: You'll need to [install Node JS][install-node] before installing Dat. Dat needs `node` version 4 or above and `npm` installed. You can run `node -v` to check your version.\n* **npm**: `npm` is installed with node. You can run `npm -v` to make sure it is installed.\n\nOnce you have `npm` ready, install `dat` from npm with the `--global, -g` option, `npm install -g dat`.\n\n### JS Library\n\nAdd Dat to your `package.json`, `npm install dat --save`. Dat exports the [dat-node] API via `require('dat')`. Use it in your javascript applications! Dat Desktop and Dat command line both use dat-node to share and download dats.\n\nFull API documentation is available in the [dat-node] repository on Github.\n\n## Getting started\n\nWe have Dat installed, let's use it!\n\nDat's unique design works wherever you store your data. You can create a new dat from any folder on your computer.\n\nA dat is some files from your computer and a `.dat` folder. Each dat has a unique `dat://` link. With your dat link, other users can download your files and live sync any updates.\n\n### Sharing Data\n\nYou can start sharing your files with a single command. Unlike `git`, you do not have to initialize a repository first, `dat share` will do that for you:\n\n```\ndat share \n```\n\nUse `dat share` to create a dat and sync your files from your computer to other users. Dat scans your files inside ``, creating metadata in `/.dat`. Dat stores the public link, version history, and file information inside the dat folder.\n\n![share-gif]\n\n### Downloading Data\n\n```\ndat clone dat://

\n```\n\nUse `dat clone` to download files from a remote computer sharing files with Dat. This will download the files from `dat://` to your ``. The download exits after it completes but you can continue to update the files later after the clone is done. Use `dat pull` to update new files or `dat sync` to live sync changes.\n\n![clone-gif]\n\nTry out `dat clone` with the link above to read more about the protocol!\n\n### Other Cool Commands\n\nA few other highlights. Run `dat help` to see the full usage guide.\n\n* `dat create` - Create an empty dat and `dat.json` file.\n* `dat doctor` - Dat network doctor! The doctor tries to connect to a public peer. The doctor also creates a key to test direct connections.\n* `dat log ~/data/dat-folder/` or `dat log dat://` - view the history and metadata information for a dat.\n\n### Quick Demos\n\nTo get started using Dat, you can try downloading a dat and then sharing a dat of your own.\n\n#### Download Demo\n\nWe made a demo folder just for this exercise. Inside the demo folder is a `dat.json` file and a gif. We shared these files via Dat and now you can download them with our dat key!\n\nSimilar to git, you can download somebody's dat by running `dat clone `. You can also specify the directory:\n\n```\n❯ dat clone dat://778f8d955175c92e4ced5e4f5563f69bfec0c86cc6f670352c457943666fe639 ~/Downloads/dat-demo\ndat v13.5.0\nCreated new dat in /Users/joe/Downloads/dat-demo/.dat\nCloning: 2 files (1.4 MB)\n\n2 connections | Download 614 KB/s Upload 0 B/s\n\ndat sync complete.\nVersion 4\n```\n\nThis will download our demo files to the `~/Downloads/dat-demo` folder. These files are being shared by a server over Dat (to ensure high availability) but you may connect to any number of users also hosting the content.\n\nYou can also also view the files online: [datbase.org/778f8d955175c92e4ced5e4f5563f69bfec0c86cc6f670352c457943666fe639](https://datbase.org/778f8d955175c92e4ced5e4f5563f69bfec0c86cc6f670352c457943666fe639/). datbase.org can download files over Dat and display them on HTTP as long as someone is hosting it. The website temporarily caches data for any visited links (do not view your dat on datbase.org if you do not want us to cache your data).\n\n#### Sharing Demo\n\nDat can share files from your computer to anywhere. If you have a friend going through this demo with you, try sharing to them! If not we'll see what we can do.\n\nFind a folder on your computer to share. Inside the folder can be anything, Dat can handle all sorts of files (Dat works with really big folders too!).\n\nFirst, you can create a new dat inside that folder. Using the `dat create` command also walks us through making a `dat.json` file:\n\n```\n❯ dat create\nWelcome to dat program!\nYou can turn any folder on your computer into a Dat.\nA Dat is a folder with some magic.\n```\n\nThis will create a new (empty) dat. Dat will print a link, share this link to give others access to view your files.\n\nOnce we have our dat, run `dat share` to scan your files and sync them to the network. Share the link with your friend to instantly start downloading files.\n\nYou can also try viewing your files online. Go to [datbase.org](https://datbase.org) and enter your link to preview on the top left. *(Some users, including me when writing this, may have trouble connecting to datbase.org initially. Don't be alarmed! It is something we are working on. Thanks.)*\n\n#### Bonus HTTP Demo\n\nDat makes it really easy to share live files on a HTTP server. This is a cool demo because we can also see how version history works! Serve dat files on HTTP with the `--http` option. For example, `dat sync --http`, serves your files to a HTTP website with live reloading and version history! This even works for dats you're downloading (add the `--sparse` option to only download files you select via HTTP). The default HTTP port is 8080.\n\n*Hint: Use `localhost:8080/?version=10` to view a specific version.*\n\nGet started using Dat today with the `share` and `clone` commands or read below for more details.\n\n## Usage\n\nThe first time you run a command, a `.dat` folder is created to store the dat metadata.\nOnce a dat is created, you can run all the commands inside that folder, similar to git.\n\nDat keeps secret keys in the `~/.dat/secret_keys` folder. These are required to write to any dats you create.\n\n## Docker Usage\n\nTo get a dat dataset using a Docker container, you can either do it directly:\n\n```\ndocker run -d --name demo-data \\\n\t\t-p 3282:3282/tcp -p 3282:3282/udp \\\n\t\t-e DATAURL=dat://778f8d955175c92e4ced5e4f5563f69bfec0c86cc6f670352c457943666fe639 \\\n\t\t-e DATADIR=/data \\\n\t\t-v $(pwd)/data:/data \\\n\t\t--entrypoint /compose-sync.yml\n\t\tdat\n```\n\nor use `compose-sync.yml` from Docker swarm mode:\n\n```\n$ docker stack up -c compose-sync.yml demo-data\nCreating network demo-data_default\nCreating service demo-data_dat-sync\n\n$ docker run --rm -v demo-data_sync:/data alpine ls /data\ndat.json\ndat_intro.gif\n```\n\nThe Docker image uses `DATADIR` and `DATAURL` if there is no dat data already available, but both environment variables\nare optional if there is already dat data in the `/data` dir.\n\n### Sharing\n\nThe quickest way to get started sharing files is to `share`:\n\n```\n❯ dat share\ndat://3e830227b4b2be197679ff1b573cc85e689f202c0884eb8bdb0e1fcecbd93119\nSharing dat: 24 files (383 MB)\n\n0 connections | Download 0 B/s Upload 0 B/s\n\nImporting 528 files to Archive (165 MB/s)\n[=-----------------------------------------] 3%\nADD: data/expn_cd.csv (403 MB / 920 MB)\n```\n\n\n#### Creating a dat & dat.json\n\n```\ndat create []\n```\n\nThe create command prompts you to make a `dat.json` file and creates a new dat. Import the files with sync or share.\n\n\n#### Syncing to Network\n\n```\ndat sync [] [--no-import] [--no-watch]\n```\n\nStart sharing your dat archive over the network.\nSync will import new or updated files since you last ran `create` or `sync`.\nSync watches files for changes and imports updated files.\n\n* Use `--no-import` to not import any new or updated files.\n* Use `--no-watch` to not watch directory for changes. `--import` must be true for `--watch` to work.\n\n#### Ignoring Files\n\nBy default, Dat will ignore any files in a `.datignore` file, similar to git. Each file should be separated by a newline. Dat also ignores all hidden folders and files.\n\nDat uses [dat-ignore] to decide if a file should be ignored.\n\n#### Selecting Files\n\nBy default, Dat will download all files. If you want to only download a subset, you can create a `.datdownload` file which downloads only the files and folders specified. Each should be separated by a newline.\n\n\n### Downloading\n\nStart downloading by running the `clone` command. This creates a folder, downloads the content and metadata, and a `.dat` folder inside. Once you started the download, you can resume using `clone` or the other download commands.\n\n```\ndat clone [] [--temp]\n```\n\nClone a remote dat archive to a local folder.\nThis will create a folder with the key name if no folder is specified.\n\n#### Downloading via `dat.json` key\n\nYou can use a `dat.json` file to clone also. This is useful when combining Dat and git, for example. To clone a dat you can specify the path to a folder containing a `dat.json`:\n\n```\ngit clone git@github.com:joehand/dat-clone-sparse-test.git\ndat clone ./dat-clone-sparse-test\n```\n\nThis will download the dat specified in the `dat.json` file.\n\n#### Updating Downloaded Archives\n\nOnce a dat is clone, you can run either `dat pull` or `dat sync` in the folder to update the archive.\n\n```\ndat pull []\n```\n\nUpdate a cloned dat archive with the latest files and exit.\n\n```\ndat sync []\n```\n\nDownload latest files and keep connection open to continue updating as remote source is updated.\n\n### Shortcut commands\n\n* `dat ` will run `dat clone` for new dats or resume the existing dat in ``\n* `dat ` is the same as running `dat sync `\n\n### Dat Registry and Authentication\n\nAs part of our [Knight Foundation grant], we are building a registry for dat archives.\nWe will be running a dat registry at datbase.org, but anyone will be able to create their own.\nOnce registered, you will be able to publish dat archives from our registry.\nAnyone can clone archives published to a registry without registration:\n\n```\ndat clone datbase.org/jhand/cli-demo\n```\n\n#### Auth (experimental)\n\nYou can also use the `dat` command line to register and publish to dat registries. Dat plans to support any registry. Currently, `datbase.org` is the only one available and the default.\n\nTo register and login you can use the following commands:\n\n```\ndat register []\ndat login\ndat whoami\n```\n\nOnce you are logged in to a registry, you can publish a dat archive:\n\n```\ncd my-data\ndat create\ndat publish --name my-dataset\n```\n\nAll registry requests take the `` option if you'd like to publish to a different registry than datbase.org.\nYou can deploy your own compatible [registry server] if you'd rather use your own service.\n\n### Key Management & Moving dats\n\n`dat keys` provides a few commands to help you move or backup your dats.\n\nWriting to a dat requires the secret key, stored in the `~/.dat` folder. You can export and import these keys between dats. First, clone your dat to the new location:\n\n* (original) `dat share`\n* (duplicate) `dat clone `\n\nThen transfer the secret key:\n\n* (original) `dat keys export` - copy the secret key printed out.\n* (duplicate) `dat keys import` - this will prompt you for the secret key, paste it in here.\n\n## Troubleshooting\n\nWe've provided some troubleshooting tips based on issues users have seen.\nPlease [open an issue][new-issue] or ask us in our [chat room][gitter-chat] if you need help troubleshooting and it is not covered here.\n\nIf you have trouble sharing/downloading in a directory with a `.dat` folder, try deleting it and running the command again.\n\n#### Check Your Dat Version\n\nKnowing the version is really helpful if you run into any bugs, and will help us troubleshoot your issue.\n\nCheck your Dat version:\n\n```\ndat -v\n```\n\nYou should see the Dat semantic version printed, e.g. `13.1.2`.\n\n### Installation Issues\n\n#### Node & npm\n\nTo use the Dat command line tool you will need to have [node and npm installed][install-node-npm].\nMake sure those are installed correctly before installing Dat.\nYou can check the version of each:\n\n```\nnode -v\nnpm -v\n```\n\n#### Global Install\n\nThe `-g` option installs Dat globally, allowing you to run it as a command.\nMake sure you installed with that option.\n\n* If you receive an `EACCES` error, read [this guide][fixing-npm-permissions] on fixing npm permissions.\n* If you receive an `EACCES` error, you may also install Dat with sudo: `sudo npm install -g dat`.\n* Have other installation issues? Let us know, you can [open an issue][new-issue] or ask us in our [chat room][gitter-chat].\n\n### Debugging Output\n\nIf you are having trouble with a specific command, run with the debug environment variable set to `dat` (and optionally also `dat-node`).\nThis will help us debug any issues:\n\n```\nDEBUG=dat,dat-node dat clone dat:// dir\n```\n\n### Networking Issues\n\nNetworking capabilities vary widely with each computer, network, and configuration.\nWhenever you run Dat there are several steps to share or download files with peers:\n\n1. Discovering Peers\n2. Connecting to Peers\n3. Sending & Receiving Data\n\nWith successful use, Dat will show `Connected to 1 peer` after connection.\nIf you never see a peer connected, your network may be restricting discovery or connection.\nPlease try using the `dat --doctor` command (see below) between the two computers not connecting. This will help troubleshoot the networks.\n\n* Dat may [have issues][dat#503] connecting if you are using iptables.\n\n#### Dat Doctor\n\nWe've included a tool to identify network issues with Dat, the Dat doctor.\nThe Dat doctor will run two tests:\n\n1. Attempt to connect to a public server running a Dat peer.\n2. Attempt a direct connection between two peers. You will need to run the command on both the computers you are trying to share data between.\n\nStart the doctor by running:\n\n```\ndat doctor\n```\n\nFor direct connection tests, the doctor will print out a command to run on the other computer, `dat doctor <64-character-string>`.\nThe doctor will run through the key steps in the process of sharing data between computers to help identify the issue.\n\n---\n\n## JS API\n\nYou can use Dat in your javascript application:\n\n```js\nvar Dat = require('dat')\n\nDat('/data', function (err, dat) {\n // use dat\n})\n```\n\n**[Read more][dat-node] about the JS usage provided via `dat-node`.**\n\n## For Developers\n\nPlease see [guidelines on contributing] before submitting an issue or PR.\n\nThis command line library uses [dat-node] to create and manage the archives and networking.\nIf you'd like to build your own Dat application that is compatible with this command line tool, we suggest using dat-node.\n\n### Installing from source\n\nClone this repository and in a terminal inside of the folder you cloned run this command:\n\n```\nnpm link\n```\n\nThis should add a `dat` command line command to your PATH.\nNow you can run the `dat` command to try it out.\n\nThe contribution guide also has more tips on our [development workflow].\n\n* `npm run test` to run tests\n* `npm run auth-server` to run a local auth server for testing\n\n## License\n\nBSD-3-Clause\n\n[Dat Project]: https://datproject.org\n[Code for Science & Society]: https://codeforscience.org\n[Dat white paper]: https://github.com/datproject/docs/blob/master/papers/dat-paper.pdf\n[Dat Desktop]: https://docs.datproject.org/install#desktop-application\n[Beaker Browser]: https://beakerbrowser.com\n[registry server]: https://github.com/datproject/datbase\n[share-gif]: https://raw.githubusercontent.com/datproject/docs/master/assets/cli-share.gif\n[clone-gif]: https://raw.githubusercontent.com/datproject/docs/master/assets/cli-clone.gif\n[Knight Foundation grant]: https://blog.datproject.org/2016/02/01/announcing-publicbits-org/\n[dat-node]: https://github.com/datproject/dat-node\n[dat-ignore]: https://github.com/joehand/dat-ignore\n[new-issue]: https://github.com/datproject/dat/issues/new\n[dat#503]: https://github.com/datproject/dat/issues/503\n[install-node]: https://nodejs.org/en/download/\n[install-node-npm]: https://docs.npmjs.com/getting-started/installing-node\n[fixing-npm-permissions]: https://docs.npmjs.com/getting-started/fixing-npm-permissions\n[guidelines on contributing]: https://github.com/datproject/dat/blob/master/CONTRIBUTING.md\n[development workflow]: https://github.com/datproject/dat/blob/master/CONTRIBUTING.md#development-workflow\n[travis-badge]: https://travis-ci.org/datproject/dat.svg?branch=master\n[travis-build]: https://travis-ci.org/datproject/dat\n[appveyor-badge]: https://ci.appveyor.com/api/projects/status/github/datproject/dat?branch=master&svg=true\n[appveyor-build]: https://ci.appveyor.com/project/joehand/dat/branch/master\n[npm-badge]: https://img.shields.io/npm/v/dat.svg\n[npm-package]: https://npmjs.org/package/dat\n[irc-badge]: https://img.shields.io/badge/irc%20channel-%23dat%20on%20freenode-blue.svg\n[irc-channel]: https://webchat.freenode.net/?channels=dat\n[gitter-badge]: https://badges.gitter.im/Join%20Chat.svg\n[gitter-chat]: https://gitter.im/datproject/discussions\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",485781164,"orgData","recentTags",[87,125],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",1666,"full_size",302977694,"id",23144068,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:94c84f46325febd03c20a2934ba4fea0265d867fd46cc48677627458db797d4f","features","","last_pulled","2026-09-20T17:50:40.444597935Z","last_pushed","2018-03-03T04:40:36Z","os","linux","os_features","os_version","size","variant","2018-03-03T04:40:35.892838Z","last_updater","last_updater_username","media_type","latest","repository",4447955,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":126,"_93":127,"_95":128,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},302977918,23142976,[129],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:f17e41f7a147030afce1355b04892978ee662115f0617bc3d0bcbaadbf09548d","2026-09-19T16:25:23.96587758Z","2018-03-03T04:40:34Z","2018-03-03T04:40:33.801027Z","add-docker-use","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":146,"_153":154,"_142":167,"_168":11},{"_36":147,"_38":148,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":149,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":150,"_75":17,"_76":152,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":151},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_155":156,"_157":-5,"_158":-5,"_159":160},"count",2,"next","previous","results",[161,164],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":162,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[163],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":126,"_93":127,"_95":165,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},[166],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

svendowideit/dat

Tags for svendowideit/dat