summaryrefslogtreecommitdiff
path: root/doc/TROUBLESHOOT.md
blob: 0e2957dfd3fbbd9816a4bfa7d2d7ceb5dff139b1 (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
# Troubleshooting #

Here are some less common issues you might run into when installing Leap Web.

## Cannot find Bundler ##

### Error Messages ###

`bundle: command not found`

### Solution ###

Make sure bundler is installed. `gem list bundler` should list `bundler`.
You also need to be able to access the `bundler` executable in your PATH.

## Incompatible ruby version ##

### Detecting the problem ###
The rubyversion we use for development and testing is noted in the file

    .ruby-version

It should match what `ruby --version` prints.

### Solution ###

Install the matching ruby version. For some operation systems this may require
the use of rbenv or rvm.

## Missing development tools ##

Some required gems will compile C extensions. They need a bunch of utils for this.

### Error Messages ###

`make: Command not found`

### Solution ###

Install the required tools. For linux the `build-essential` package provides most of them. For Mac OS you probably want the XCode Commandline tools.

## Missing libraries and headers ##

Some gem dependencies might not compile because they lack the needed c libraries.

### Solution ###

Install the libraries in question including their development files.
Usually the missing library is mentioned in the error message. Searching the
internet for similar errors is a good starting point aswell.