Surprised this one hasn't been asked yet.

But how / what is the recommended best practice for shutting down bitcoind ?

Right now I'm manually killing the process with either sudo kill {pid} or if this is failing (like just now) using sudo pkill -9 -f bitcoind


I guess using bitcoind stop. I recommend this approach as killing the process could end you up with a corrupted database, from what I have experienced. Use bitcoind --help for all options and bitcoind help for all JSON-RPC commands.

  • Good thinking. Missed that. – ManreeRist Oct 11 '13 at 19:11
  • 6
    This doesn't work anymore: Error: Command line contains unexpected token 'stop', see bitcoind -h for a list of options.. The correct way to stop bitcoind is bitcoin-cli-stop command (see the other answer with higher vote count). – iaforek Oct 23 '17 at 8:10

I'm not sure if bitcoind stop still works as RPC with newer releases, since somewhere in help sections it says RPC funcionality removed from bitcoind.

Try bitcoin-cli stop.

  • 5
    Confirmed bitcoin-cli stop works in version 11. – Jonathan Cross Sep 17 '15 at 12:42
  • 2
    Still works in 2017! Use this. – iaforek Oct 23 '17 at 8:14
  • does not work... I did ./xxxcoin-cli stop but nothing happen after that and ./xxxcoind also does not stopped. – creator Feb 21 '18 at 12:29
  • 1
    Yes, it still works. – Ken Sharp Aug 1 '18 at 23:17

if you started it using 'bitcoind -daemon' and you are using version 10 or above, then use 'bitcoin-cli stop'


In my case, It works that ./bitcoin-cli -regtest stop


Make sure you specify the same options that you normally use when running bitcoin, for example, if you use a different datadir:

cd C:\Program Files\Bitcoin\daemon
bitcoin-cli -datadir=C:\Bitcoin stop

If using testnet, try ./bitcoin-cli -testnet stop

  • 1
    ./bitcoin-cli stop is enough – 0xb10c Aug 3 '18 at 8:51
  • I don't know why this correct and the only working answer when on testnet was down-voted. ./bitcoin-cli stop is definitely not enough when running 0.18rc on testnet. – Tony Mar 14 at 5:30

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.