fix path in readme
[electrum-server.git] / README.leveldb
1 How to run a pruning node with leveldb
2
3 Pruning nodes use a lightweight database to store address histories.
4 Only unspent coins are kept in that database; spent outputs are
5 pruned.
6
7
8 __________________________________________________________
9 1. patch and compile bitcoind.
10
11 Install version 0.8 or equivalent.
12
13 Note: Even though Electrum's database uses pruning, you cannot use it
14 with a pruning bitcoind. A full bitcoin node is required in order to
15 know for each address if it has been used. Pruning occurs only at the
16 level of the Electrum database.
17
18 __________________________________________________________
19
20 2. Install python-leveldb: 
21
22 sudo apt-get install python-leveldb
23
24 __________________________________________________________
25
26 3. edit /etc/electrum.conf : 
27
28 [server]
29 backend = leveldb
30
31 [leveldb]
32 path = /path/to/your/database
33
34 ______________________________________________________________
35
36 4. catch up with the blockchain.
37
38 In order to speed up the initial catch_up phase, it is recommended to
39 locate your database in shared memory:
40
41  dbpath = /run/shm/electrum_db
42
43 Once your server has finished catching up, copy your database to disk
44 and update the path in /etc/electrum.conf
45
46 During the catch_up phase, you can interrupt the server with Ctrl-C;
47 it will safely write the current status in the database and exit.
48
49 _________________________________
50
51 5. enjoy!
52
53 Once the server is synchronized, it will listen to ports, and the
54 normal way to stop it is to type: ./server.py stop
55
56 Other commands are available: 
57
58 ./server info   : view connections
59 ./server load   : view the size of the queue
60
61
62