# Installing the dolt command line

## Prerequisites

* Make sure git is installed
* Setup ssh keys for github authentication: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/
* Clone this repo and pull the latest
* Install go: https://golang.org/doc/install
* run: git config --global --add url."ssh://git@github.com".insteadOf "https://github.com"
* Configure your environment with important variables. Put these in your .bash_profile / .bashrc
  * Set your `GOPATH` environment variable: 
      *     export GOPATH=`go env GOPATH`
      * If your go workspace is somewhere other than the default of `~/go`, set `GOPATH` manually via an export directive in your .bash_profile, e.g. `export GOPATH=/workspaces/liquidata/go`
  * `export NOMS_VERSION_NEXT=1`
  * Add the go binary installation directory to your `PATH` variable (`export PATH=$GOPATH/bin:$PATH`).
* This helper function can also be added to make installation easier:

``` bash
dolt_install() {
  pushd ~/go/src/github.com/liquidata-inc/ld/dolt/go/cmd/dolt
  GO111MODULE=on go install .
  popd
}
```

* Windows installation
  * Do whatever windows stuff you gotta do so that %USERPROFILE%/go/bin is part of the path
 
## Installation

* If you setup dolt_install
  * run: dolt_install
* If not
  * Open a command line in the dolt/go directory
  * run: GO111MODULE=on go install . 
 
 
## First commands

* dolt config --global --add user.email YOU@liquidata.co
* dolt config --global --add user.name "YOUR NAME"
 
## Setting up a repo

* make a new directory with nothing in it
* From the new directory run dolt init
 
## Docs

* The latest documentation will always be in the tool itself.  run "dolt" to see a list of standard git like commands.  
run "dolt table" to see the table subcommands.  To get the help for any command use the --help flag after the name of the command.
* Initial version of the documentation looks like this: https://docs.google.com/document/d/169Zhh_r1hmxZo5V3N_aOx7i6ImJCVBbaB8EBXyH8p3o/edit#