Jump to: navigation, search

Install and Configure Namecoin

Quick start on Linux

1 Download & Install

We recommend experienced users and servers switch to Namecore.

The fastest way to get going on Linux is to add the following to your package manager:

You can also build namecoin from source.

2 Add Config

mkdir -p ~/.namecoin \
&& echo "rpcuser=`whoami`" >> ~/.namecoin/namecoin.conf \
&& echo "rpcpassword=`openssl rand -hex 30/`" >> ~/.namecoin/namecoin.conf \
&& echo "rpcport=8336" >> ~/.namecoin/namecoin.conf

3 Run Namecoin

namecoind -daemon

If you start namecoind for the first time, it automatically downloads the Namecoin blockchain. This usually takes 12 hours, but there are a few things you can do to speed things up.

Detailed Instructions

1 Download

Visit the download page for links to binaries and packages. Miners and advanced users should use Namecore.

2 Configuration

Create a namecoin.conf file in the configuration directory for your system.

Configuration File Location
Windows  %APPDATA%
Linux ~/.namecoin
Mac OS X ~/.namecoin (legacy) '/Users/USERNAME/Library/Application Support/Namecoin/namecoin.conf'

Populate a file "namecoin.conf" with at least these lines:


Replace your_user and your_pass with any values of your choosing.

3 Usage

After creating the configuration file re/start namecoind.

Namecoin runs in the background and will fetch the blockchain (which can take several hours), do not attempt any transactions until the blockchain has completed downloading. You can check progress by comparing the blockcount returned by getinfo against the explorer.namecoin.info blockcount.

Running on Server


We suggest 512MB of RAM but you might be able to get away with 256MB. The chain is still fairly compact, ~3 GB as of 2015.


Warning: this has not been updated for/tested with Namecoin Core.

If you want to run namecoind as a daemon by default (and skip the -daemon flag) add daemon=1 to your namecoin.conf file:

echo "daemon=1" >> ~/.namecoin/namecoin.conf


Add the following to /etc/systemd/system/namecoin.service and enable it with systemctl enable namecoin. You will either need to add a namecoin user or change the 'user' parameter below (such as 'ubuntu'). Only tested with daemon=1 set in namecoin.conf.

Description=Namecoin daemon service

Upstart Script

The following Upstart script will enable the standard sudo start/stop/resetart namecoind commands on Ubuntu. Save it into /etc/init/namecoind.conf and then run sudo initctl reload-configuration.

Note that if you have a dedicated Namecoin user, you will need to change the user.

description "namecoind"

start on filesystem
stop on runlevel [!2345]
oom never
expect daemon
respawn limit 10 60 # 10 times in 60 seconds

# Don't change anything below here unless you know what you're doing
[[ -e $pidfile && ! -d "/proc/$(cat $pidfile)" ]] && rm $pidfile
[[ -e $pidfile && "$(cat /proc/$(cat $pidfile)/cmdline)" != $cmd* ]] && rm $pidfile
exec start-stop-daemon --start -c $user --chdir $home --pidfile $pidfile --startas $cmd -b --nicelevel 10 -m
end script

Important Commands




Start Namecoin daemon

namecoind help

Show all available commands

namecoind getinfo

Show various information. The "blocks" value should match the current block count[1]

namecoind listreceivedbyaddress 0 true

List your Namecoin address on which you can receive Namecoins

namecoind getnewaddress

Create a new Namecoin address

namecoind name_new d/foobar

Reserve a domain name. See Register and Configure .bit Domains for more information.