monero-site/resources/user-guides/mining_with_xmrig_and_docker.md

---
layout: static_page
title: "Mining with XMRig and Docker"
title-pre-kick: "Mining XMR"
title-kick: "With XMRig and DOcker"
title-post-kick: ""
kick-class: "purple-kicks"
icon: "icon_userguides"
attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and is licensed under Creative Commons BY 3.0 -->"
---

## Introduction

This guide is two fold, ease of use for mining on Linux distributions and some extra security around mining as most of these miners have not had security auditing.

At the end of this guide you will be able to sleep a little easier knowing that if the miner gets exploited it will not migrate to your OS.

### Why Docker

[Docker](https://www.docker.com/) is being used as it is the most well known and has the biggest chance to be already installed.

The container I an using is [alpine-xmrig](https://hub.docker.com/r/bitnn/alpine-xmrig/) as per the name it is built on the [Alpine Linux](https://www.alpinelinux.org/) image.

If you are interested in getting started with Docker, here are some really good starting references.
* Arch Linux Wiki [Docker Page](https://wiki.archlinux.org/index.php/Docker)
* Container Solutions [Security Cheat Sheet](http://container-solutions.com/content/uploads/2015/06/15.06.15_DockerCheatSheet_A2.pdf)
* Digital Oceans [Dockerfile Howto](https://www.digitalocean.com/community/tutorials/docker-explained-using-dockerfiles-to-automate-building-of-images).

For distribution specific installation please refer to the [Docker Docs](https://docs.docker.com/engine/installation/) website.

### Why XMRig

[XMRig](https://github.com/xmrig/xmrig) is just a really solid miner to me. Nice output and statistics, no flashy web-ui's or dependencies. The XMRig container is only ~4MB what makes it extremely portable. 

#### Step 1: Mining with XMRig

Run the following

```bash
# docker run --restart unless-stopped --read-only -m 50M -c 512 bitnn/alpine-xmrig -o POOL01 -o POOL02 -u WALLET -p PASSWORD -k
# docker run --restart unless-stopped --read-only -m 50M -c 512 bitnn/alpine-xmrig -o pool.supportxmr.com:7777 -u 45CJVagd6WwQAQfAkS91EHiTyfVaJn12uM4Su8iz6S2SHZ3QthmFM9BSPHVZY388ASWx8G9Wbz4BA24RQZUpGczb35fnnJz -p docker:secret -k
```

#### Step 2: There is no Step 2

You have already done everything you need to do. You are now mining in a docker container with XMRig `ctrl+c` to exit the miner or add `-d` just after `docker run` to background the miner.
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00			`---`
			`layout: static_page`
			`title: "Mining with XMRig and Docker"`
			`title-pre-kick: "Mining XMR"`
			`title-kick: "With XMRig and DOcker"`
			`title-post-kick: ""`
			`kick-class: "purple-kicks"`
			`icon: "icon_userguides"`
			`attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and is licensed under Creative Commons BY 3.0 -->"`
			`---`

Added spaces to heading format correctly 2017-07-13 01:06:46 +03:00			`## Introduction`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
			`This guide is two fold, ease of use for mining on Linux distributions and some extra security around mining as most of these miners have not had security auditing.`

			`At the end of this guide you will be able to sleep a little easier knowing that if the miner gets exploited it will not migrate to your OS.`

Added spaces to heading format correctly 2017-07-13 01:06:46 +03:00			`### Why Docker`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
Added Docker references for new comers 2017-07-13 01:21:47 +03:00			`[Docker](https://www.docker.com/) is being used as it is the most well known and has the biggest chance to be already installed.`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
			`The container I an using is [alpine-xmrig](https://hub.docker.com/r/bitnn/alpine-xmrig/) as per the name it is built on the [Alpine Linux](https://www.alpinelinux.org/) image.`

Added Docker references for new comers 2017-07-13 01:21:47 +03:00			`If you are interested in getting started with Docker, here are some really good starting references.`
			`* Arch Linux Wiki [Docker Page](https://wiki.archlinux.org/index.php/Docker)`
			`* Container Solutions [Security Cheat Sheet](http://container-solutions.com/content/uploads/2015/06/15.06.15_DockerCheatSheet_A2.pdf)`
			`* Digital Oceans [Dockerfile Howto](https://www.digitalocean.com/community/tutorials/docker-explained-using-dockerfiles-to-automate-building-of-images).`

			`For distribution specific installation please refer to the [Docker Docs](https://docs.docker.com/engine/installation/) website.`
Added spaces to heading format correctly 2017-07-13 01:06:46 +03:00
			`### Why XMRig`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
			`[XMRig](https://github.com/xmrig/xmrig) is just a really solid miner to me. Nice output and statistics, no flashy web-ui's or dependencies. The XMRig container is only ~4MB what makes it extremely portable.`

Added spaces to heading format correctly 2017-07-13 01:06:46 +03:00			`#### Step 1: Mining with XMRig`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
			`Run the following`

			```bash
			`# docker run --restart unless-stopped --read-only -m 50M -c 512 bitnn/alpine-xmrig -o POOL01 -o POOL02 -u WALLET -p PASSWORD -k`
			`# docker run --restart unless-stopped --read-only -m 50M -c 512 bitnn/alpine-xmrig -o pool.supportxmr.com:7777 -u 45CJVagd6WwQAQfAkS91EHiTyfVaJn12uM4Su8iz6S2SHZ3QthmFM9BSPHVZY388ASWx8G9Wbz4BA24RQZUpGczb35fnnJz -p docker:secret -k`
			```

Added spaces to heading format correctly 2017-07-13 01:06:46 +03:00			`#### Step 2: There is no Step 2`
Adding user guide: mining with docker and xmrig 2017-07-11 14:57:41 +03:00
			You have already done everything you need to do. You are now mining in a docker container with XMRig `ctrl+c` to exit the miner or add `-d` just after `docker run` to background the miner.