The commands in this guide should be executed in a Terminal application.
The built-in one is located in /Applications/Utilities/Terminal.app
.
Install the macOS command line tools:
xcode-select --install
When the popup appears, click Install
.
Then install Homebrew.
brew install automake berkeley-db4 libtool boost miniupnpc openssl pkg-config protobuf python qt libevent qrencode
See dependencies.md for a complete overview.
If you want to build the disk image with make deploy
(.dmg / optional), you need RSVG
brew install librsvg
It is recommended to use Berkeley DB 4.8. If you have to build it yourself, you can use the installation script included in contrib/ like so
./contrib/install_db4.sh .
from the root of the repository.
Note: You only need Berkeley DB if the wallet is enabled (see the section Disable-Wallet mode below).
Clone the Litecoin Core source code and cd into litecoin
git clone https://github.com/litecoin-project/litecoin
cd litecoin
Build Litecoin Core:
Configure and build the headless Litecoin Core binaries as well as the GUI (if Qt is found).
You can disable the GUI build by passing --without-gui
to configure.
./autogen.sh
./configure
make
It is recommended to build and run the unit tests:
make check
You can also create a .dmg that contains the .app bundle (optional):
make deploy
Installation into user directories (optional):
make install
or
cd ~/litecoin/src
cp litecoind /usr/local/bin/
cp litecoin-cli /usr/local/bin/
Litecoin Core is now available at ./src/litecoind
Before running, it's recommended that you create an RPC configuration file.
echo -e "rpcuser=litecoinrpc\nrpcpassword=$(xxd -l 16 -p /dev/urandom)" > "/Users/${USER}/Library/Application Support/Litecoin/litecoin.conf"
chmod 600 "/Users/${USER}/Library/Application Support/Litecoin/litecoin.conf"
The first time you run litecoind, it will start downloading the blockchain. This process could take several hours.
You can monitor the download process by looking at the debug.log file:
tail -f $HOME/Library/Application\ Support/Litecoin/debug.log
./src/litecoind -daemon # Starts the litecoin daemon.
./src/litecoin-cli --help # Outputs a list of command-line options.
./src/litecoin-cli help # Outputs a list of RPC commands when the daemon is running.
Tested on OS X 10.10 Yosemite through macOS 10.13 High Sierra on 64-bit Intel processors only.
Building with downloaded Qt binaries is not officially supported. See the notes in #7714