Public Repository

Last pushed: a year ago
Short Description
Blockstack - A New Internet for Decentralized Apps
Full Description

Blockstack is a new decentralized internet where users own their data and apps run locally.

This is a developer preview.


  • Based on the super slim tklx/base (Debian GNU/Linux).
  • Uses tini for zombie reaping and signal forwarding.
  • Includes blockstack core, virtualchain and the browser portal. We will most likely split the different components into different containers in the future, and provide documentation/wrapper scripts for container linking.


Pull the blockstack container and run it, dropping to a shell

docker pull tklx/blockstack
docker run --rm -it \
    -p \
    -p \
    -p \
    tklx/blockstack /bin/bash

In the shell, setup blockstack core and start the api

source /blockstack/core/bin/activate
blockstack setup -y --password "$BITCOIN_WALLET_PASSWORD"
sed -i "s/localhost/" ~/.blockstack/client.ini
blockstack api start -y --password "$BITCOIN_WALLET_PASSWORD" --debug

Take note of your wallet and api passwords

grep api_password ~/.blockstack/client.ini | sed 's/api_password = //g'

Start the cors proxy and browser portal

cd /blockstack/portal
CORSPROXY_HOST= npm run dev-proxy &
npm run dev

Browse to http://localhost:3000 (the portal). You'll need to enter the api password you took note of above.

Tip: setup a protocol-handler

Automated builds

The Docker image is built, and pushed by CircleCI from source hosted on GitHub.

  • Tag: x.y.z refers to a release (recommended).
  • Tag: latest refers to the master branch.

Issue Tracker

TKLX uses a central issue tracker on GitHub for reporting and tracking of bugs, issues and feature requests.

Docker Pull Command