> For the complete documentation index, see [llms.txt](https://xel.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xel.gitbook.io/wiki/tutorials/xel_miner/macos.md).

# MacOS - miner tutorial

## Install from Source

{% code title="#install\_guide" %}

```bash
# Make sure you have homebrew installed (if you do, skip this step):
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# Make sure to install all required dependencies
brew install gmp make cmake openssl

# Get the latest source code (or run a git pull to update)
git clone https://github.com/OrdinaryDude/xel_miner

# Make sure to link the OpenSSL include directory to the right place
ln -s /usr/local/opt/openssl/include/openssl/ /usr/local/include/openssl

# Compile the miner
cd xel_miner
OPENSSL_ROOT_DIR=/usr/local/opt/openssl cmake .
make
```

{% endcode %}

You can test if it’s functioning properly by running:

{% code title="#run" %}

```bash
xel_miner --test-vm examples/SHA256_BTC.epl
```

{% endcode %}

## Video tutorial

{% embed url="<https://vimeo.com/265864791>" %}
xel\_miner on MacOS
{% endembed %}

{% content-ref url="/pages/-LCj\_axtcAgEK-n6KgUI" %}
[Linux - miner tutorial](/wiki/tutorials/xel_miner/linux.md)
{% endcontent-ref %}

>