aboutsummaryrefslogtreecommitdiffstats
path: root/docs/install.md
blob: 0d53b547cd2a7bdcf10aaf4ca4759acd6e573206 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# Welcome to Dat!

Dat has a Desktop client, a commandline tool, and a Node.js library. If you'd like to read about how dat works, please [read how it works](/concepts) and if you're still hungry for more learning, [read the Dat paper](https://github.com/datproject/docs/blob/master/papers/dat-paper.pdf).

Have questions or need some guidance? You can chat with us in IRC on [#dat](http://webchat.freenode.net/?channels=dat) or [Gitter](https://gitter.im/datproject/discussions?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)!

## Desktop Application

If you don't want to use the terminal, you can use our desktop application on Mac or Linux (Windows coming soon).

| Platform | Link             |
|---------|-------------------|
| Mac     | [Download .dmg](http://datproject.github.io/dat-desktop/mac)          |
| Linux   | [Download .AppImage](http://datproject.github.io/dat-desktop/linux)          |
| Windows | Coming Soon       |


## In the Terminal

Dat can be installed in the terminal using `node`. Follow the instructions below to get started.

1. **Install Node.** Dat requires Node version 4.0 or higher; however, we recommend the latest version. If you don't have node, [go to their website at nodejs.org and pick your platform.](https://nodejs.org/en/download/) If node is installed, you should be able to type the following to see which version you have:

```
$ node -v
8.0.0
```

2. **Install Dat.** Dat is distributed using `npm`, the package manager for Node.js. Type the following command to install dat:

```
npm install -g dat
```

If dat was installed successfully, you might see output like this (on npm 5.0.0):
```
/usr/local/bin/dat -> /usr/local/lib/node_modules/dat/bin/cli.js

> utp-native@1.5.1 install /usr/local/lib/node_modules/dat/node_modules/utp-native
> node-gyp-build


> sodium-native@1.10.0 install /usr/local/lib/node_modules/dat/node_modules/sodium-native
> node-gyp-build "node preinstall.js" "node postinstall.js"

added 321 packages in 9.662s
```

If you receive an `EACCES` error, read [this guide on fixing npm permissions](https://docs.npmjs.com/getting-started/fixing-npm-permissions) or use `sudo npm install -g dat`.

If you're still having trouble installing dat, see the [troubleshooting section](/troubleshooting), [open an issue on Github](https://github.com/datproject/dat/issues/new), or [ask us a question in our chat room](https://gitter.im/datproject/discussions).

## Next Steps

You're all set! [Go on to the next page to start sharing data](/tutorial).