cbeams/vanitygen repository overview

vanitygen is a tool that generates custom bitcoin addresses such as this one:

1BeamsTXoQ4rXzogaqsLR8Cgd8sf98oGGb

This Docker image contains a ready-to-use vanitygen binary built from the unmodified sources on the master branch of samr7's original vanitygen repository⁠. I've forked this repo⁠ just for the purpose of adding the Dockerfile used to build this image⁠.

To use:

$ docker run cbeams/vanitygen:latest vanitygen 1Text

where "Text" is whatever vanity name you want. Note that the leading 1 is not optional. vanitygen will then work for as long as necessary to generate a bitcoin address that matches your desired text and will then print out the public and private keys. Be prepared to write this down somewhere, and consult your wallet software for instructions on how to import that private key into your wallet safely and securely.

I have built this image for convenience; there are no guarantees about security. If you don't trust the pre-built vanitygen binary, you can rebuild it yourself by logging into the container, inspecting the sources for yourself, and running make:

$ docker run -ti cbeams/vanitygen:latest /bin/bash
$ cd /usr/local/src/vanitygen
# explore the repo, make sure the code is untainted, etc.
$ git remote show origin
* remote origin
  Fetch URL: https://github.com/cbeams/vanitygen.git
...
$ make clean
$ make

This image already has a symlink at /usr/local/bin/vanitygen pointing to the binary at at /usr/local/src/vanitygen/vanitygen, so everything should "just work" when you finish running make.

For more information, see the blog post at http://chris.beams.io/posts/vanitygen⁠

Enjoy.