Skip to content

Commit 749f03b

Browse files
Update instruction on installing the node from source
1 parent 20e248f commit 749f03b

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

docs/getting-started/install.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,34 @@ sudo apt-get update -y
4545
sudo apt-get install automake build-essential pkg-config libffi-dev libgmp-dev libssl-dev libtinfo-dev libsystemd-dev zlib1g-dev make g++ tmux git jq wget libncursesw5 libtool autoconf liblmdb-dev -y
4646
```
4747

48+
Possible issue with `pkg-config`:
49+
50+
`pkgconf` 1.9.5 (which is default in `Fedora 39` and `Rawhide`) produces output unreadable by `cabal`, which results in an errors like:
51+
52+
```
53+
conflict: pkg-config package libsodium-any, not found in the pkg-config database
54+
```
55+
56+
despite having `libsodium` installed in the system.
57+
58+
The possible solutions to this problem are:
59+
60+
- to upgrade `pkgconf` to version 2 by building it from source:
61+
```
62+
yum update -y && \
63+
yum install git diffutils gcc gcc-c++ tmux gmp-devel make tar xz wget zlib-devel libtool autoconf -y && \
64+
mkdir -p /root/src/ && cd /root/src && \
65+
curl -O https://distfiles.ariadne.space/pkgconf/pkgconf-2.0.3.tar.xz && \
66+
tar -xvf pkgconf-2.0.3.tar.xz && \
67+
cd pkgconf-2.0.3 && \
68+
./configure && make && make install && \
69+
```
70+
71+
- to use `cabal` version (higher than `3.10.2.0`) that have these changes already integrated:
72+
- [Try each pkg-config query separatedly](https://github.com/haskell/cabal/pull/9134)
73+
- [fix pkgconf 1.9 --modversion regression](https://github.com/haskell/cabal/pull/9391)
74+
75+
4876
Optional dependencies that may be required: llvm libnuma-dev
4977

5078
If you are using a different flavor of Linux, you will need to use the correct package manager for your platform instead of `yum` or `apt-get`, and the names of the packages you need to install might differ.
@@ -282,6 +310,7 @@ Build the node and CLI with `cabal`:
282310
```bash
283311
cabal update
284312
cabal build all
313+
cabal build cardano-cli
285314
```
286315

287316
Install the newly built node and CLI commands to the `~/.local/bin` directory:

0 commit comments

Comments
 (0)