# Troubleshooting

## Installing aragonCLI

### Unix considerations <a href="#unix-considerations" id="unix-considerations"></a>

If you're seeing several installation errors (e.g. `node-gyp rebuild`), the problem is probably due to an outdated Node.js version.

aragonCLI currently supports the latest releases of the following Node.js versions: 10, 11 and 12. Recommended version is `node 12.7`

Errors could also be do to the need for `python2` as a dependency. In that case run:

```
sudo apt install python2
npm config set python "/usr/bin/python2.7"
```

If you're seeing errors similar to:

```
EACCES: permission denied
```

It's probably because you originally installed Node with root permissions. Because of this, writing to your npm directory (`npm -i -g`) requires root permissions too.

While it's not a good idea to have Node installed this way, one way to quickly give yourself root permissions is to run the slightly modified command:

```
sudo npm i -g --unsafe-perm @aragon/cli
```

An arguably better way to fix the problem is to follow the steps outlined in this [stackoverflow answer.](https://stackoverflow.com/a/24404451)

In case of

### Windows considerations <a href="#windows-considerations" id="windows-considerations"></a>

Windows is not officially supported by aragonCLI at the moment.

You might need to run the shell with administrator rights when installing the aragonCLI, because our `go-ipfs` dependency will need to create a symlink to work correctly.

If you have problems during the instalation of aragonCLI or any other dependencies. You probably need to install [windows-build-tools](https://www.npmjs.com/package/windows-build-tools) or similar package.

Again, if you're having trouble fixing things, please reach out to us in our [#questions-channel](https://discord.gg/XgCeeKYd) on the Discord Server.

## Note on Git <a href="#note-on-git" id="note-on-git"></a>

You might need to have [Git](https://git-scm.com/) installed. If you're unsure what Git is, or whether you have it installed, we recommend you follow [this tutorial.](https://www.learnenough.com/git-tutorial/getting_started)

## Resetting the devchain <a href="#resetting-the-devchain" id="resetting-the-devchain"></a>

After upgrading aragonCLI, or if unexpected errors are being experienced, [resetting the devchain](https://legacy-docs.aragon.org/developers/tools/aragoncli/main-commands) (by doing `aragon devchain --reset` or `aragon run --reset`) is sometimes useful as it will restart the chain from the snapshot.

## The \~/.aragon directory <a href="#the-aragon-directory" id="the-aragon-directory"></a>

The aragonCLI creates the `.aragon` directory under the user directory where it saves the state of the devchain and the [Aragon client.](https://legacy-docs.aragon.org/developers/tools/the-basics/the-aragon-client)

In case the client is not loading properly, deleting the `~/.aragon` directory will make `aragon run` recreate the environment the next time it is used and may solve the issue.

## Set a private key <a href="#set-a-private-key" id="set-a-private-key"></a>

For interacting with aragonCLI you can configure a private key in `~/.aragon`. Create a file `<network>_key.json` (eg. `rinkeby_key.json`) with this structure:

```json
{
  "rpc": "https://<network>.eth.aragon.network",
  "keys": ["put-your-priv-key-here"]
}
```

Then if you use `--environment aragon:<network>` when using the aragonCLI commands it will use that account.

You can also define a `~/.aragon/mnemonic.json` file like:

```json
{
  "mnemonic": "explain tackle mirror kit ..."
}
```

## Verifying your contracts <a href="#verifying-your-contracts" id="verifying-your-contracts"></a>

You can validate the smart contract and other files of a specific app installed in your Aragon organization with:

```
dao apps <org-address>
```

For example `voting@1.1.5`. We can check the information for that deployment in the [`deploys.yml` file](https://github.com/aragon/deployments/blob/470c6929674a4afe4f89f9a6917578f7e9486d39/environments/rinkeby/deploys.yml#L40). Be sure to look in the environment you are working (eg. rinkeby).

You can check the `commitHash` in aragon-apps GitHub repo and view the smart contract code that was deployed for that specific version. For `v1.1.5` this is the [code deployed](https://github.com/aragon/aragon-apps/blob/d99b6e9d62d3de47601077adb6b3b14fbe92f8a9/apps/voting/contracts/Voting.sol).

## IPFS <a href="#ipfs" id="ipfs"></a>

### IPFS version <a href="#ipfs-version" id="ipfs-version"></a>

If you have a version older than `0.4.22`, you should first uninstall your current version with `aragon ipfs uninstall` and install IPFS again with `aragon ipfs install`.

### Resetting IPFS <a href="#resetting-ipfs" id="resetting-ipfs"></a>

After upgrading aragonCLI, or if unexpected errors are being experienced, resetting IPFS by deleting the `~/.ipfs` directory and then run `aragon ipfs` sometimes help.

### Local IPFS node having trouble loading information from Aragon's IPFS server <a href="#local-ipfs-node-having-trouble-loading-information-from-aragon-s-ipfs-server" id="local-ipfs-node-having-trouble-loading-information-from-aragon-s-ipfs-server"></a>

The best way around this is to:

1. Keep trying on the local ipfs daemon
2. Try accessing that same file in a more generic gateway, like `ipfs.io/ipfs`
3. Downloading our [deployments repo](https://github.com/aragon/deployments) and running `npm run pin` to load all of the previous deployments into your local ipfs daemon (this is *a lot* of data though; \~2gb right now). Alternatively you can decompress the archive you need and then just pin that.

### Propagating your content hash through IPFS <a href="#propagating-your-content-hash-through-ipfs" id="propagating-your-content-hash-through-ipfs"></a>

When publishing a package via `aragon apm publish`, you will be returned an IPFS content (root) hash. For the Aragon client to load these files through its default IPFS configuration, this hash needs to be accessible at: `https://ipfs.eth.aragon.network/ipfs/<hash>`.

The best way to propagate and keep your app's content accessible is to pin it via a cloud IPFS-pinning service like [Pinata](https://pinata.cloud/) or [Temporal](https://temporal.cloud/). These services generally offer a generous free-tier that will allow you to host your app if it is not too large.

Otherwise, as a quick fix, if you are running into issues with your hash being propagated to this URL, try running `ipfs propagate <hash>` or the following steps.

1. If you have `aragon ipfs` running, quit that daemon.
2. Run the command `ipfs daemon --enable-namesys-pubsub`.
3. Propagate your content through public gateways.
   * Request your content hash at the following gateways. The `index.html` will automatically be loaded if it's available in the hash's root directory:
     * `https://ipfs.eth.aragon.network/ipfs/<hash>`
     * `https://ipfs.io/ipfs/<hash>`
     * `https://ipfs.infura.io/ipfs/<hash>`
     * [Check this list](https://discuss.ipfs.io/t/curated-list-of-ipfs-gateways/620) for additional gateways if you are having trouble with propagating.
   * If your content also includes an `artifact.json` or `manifest.json`, make sure to separately request these as they will usually not be requested by the `index.html`:
     * `<gateway>/ipfs/<hash>/artifact.json`
     * `<gateway>/ipfs/<hash>/manifest.json`
   * Keep retrying if any files don't immediately become available.
4. Once successful with step 3, request your hash at the Aragon gateway to double check it has propagated and is immediately accessible by the Aragon client:
   * `https://ipfs.eth.aragon.network/ipfs/<hash>`
   * (If applicable) `https://ipfs.eth.aragon.network/ipfs/<hash>/artifact.json`
   * (If applicable) `https://ipfs.eth.aragon.network/ipfs/<hash>/manifest.json`

Note that it is best practice to pin the content hash to an IPFS server you manage to ensure its future availability.

## Metamask <a href="#metamask" id="metamask"></a>

### Using Metamask <a href="#using-metamask" id="using-metamask"></a>

To interact with your organization using [Metamask](https://metamask.io/) you must make sure that:

* It's unlocked
* Private network (*Localhost 8545*) is chosen
* The first account provided by `aragon run` or `aragon devchain` is imported and selected. To import the account, copy the private key (something like `a8a5...1563`), go to the Metamask accounts upper icon (to the left of the hamburguer button), scroll down, click on "Import account" and paste the value you copied.

### Issues sending transactions <a href="#issues-sending-transactions" id="issues-sending-transactions"></a>

Because of the way that Metamask caches the account nonces for the different networks, you may be getting the following error when interacting with your app:

```
Error: the tx doesn't have the correct nonce. account has nonce of: 157 tx has nonce of: 158
```

The workaround is to switch to a different network (e.g. Rinkeby) and then switch back to the *Localhost 8545* network. This will refresh Metamask's account nonce cache. Sending transactions should now succeed.