# NOTE: This article contains both upgrade instructions, AND install-from-fresh instructions.

This article is designed for those running a previous version of my Steem-in-a-box software, or for those looking to set up a new witness server. 

If you want to learn more about witnesses and what they do, check out my article here: https://steemit.com/witness-category/@someguy123/seriously-what-is-a-witness-why-should-i-care-how-do-i-become-one-answer

**NEW FEATURES**

new features include:

 - `dlblocks` (downloads blocks from @gtg's server, decompresses them into the right folder)
 - `install_docker` (downloads and installs docker. if not running as root, auto adds your current user to the docker group)
 - `remote_wallet` (runs cli_wallet against steemd.steemit.com)

<center>![](https://i.imgur.com/XOsLHJQ.png)</center>

UPGRADING FROM HF18
==================

If you have a previous installation of Steem-in-a-box, simply do the following:

Update your steem-in-a-box scripts:

```
git pull
```

Disable your witness, or change it to your backup key

```
./run.sh wallet

locked>> unlock "supersecurepassword"
unlocked>> update_witness "someguy123" "yoururl" "STM1111111111111111111111111111111114T1Anm" {"account_creation_fee":"0.200 STEEM","maximum_block_size":131072,"sbd_interest_rate":0} true
```

Now stop the witness server

```
./run.sh stop
```

Now, make sure you delete the /dev/shm files, as they will not be compatible with HF19 and need to be re-built

```
rm -rf /dev/shm/*
```

Finally, update your STEEM image, then start it with replay


```
./run.sh install
./run.sh replay
```

You can now check the logs with ./run.sh logs and see that it's rescanning the blockchain. 

Once it's fully replayed, you can re-broadcast your witness :)

```
 update_witness "someguy123" "yoururl" "STM1abcdabcdabcdabcdabcdbdcabacbdcab" {"account_creation_fee":"0.200 STEEM","maximum_block_size":131072,"sbd_interest_rate":0} true
```


Installing a NEW witness
==================

To become a witness, you'll require a server with at LEAST 8GB of RAM, 100GB disk, and a fast, reliable network. I recommend @privex - they accept STEEM, are affordable, and [sell servers with a Zero Block Miss SLA](https://steemit.com/introduceyourself/@privex/we-are-privex-inc-we-accept-steem-protecting-your-privacy-in-the-cloud)

I personally use @privex for my own witness, as proof of their quality - I haven't missed a block since moving to them months ago, and I get almost 60 per day. (DISCLAIMER: I'm the CEO of Privex Inc. however you'll find plenty of people here on STEEM unaffiliated with us, praising our servers and network)

You're free to use any other server provider. I don't recommend trying to run a witness on your home internet, as it is likely not reliable enough for a witness.

Be aware that certain server providers have poor networks or hardware, and may cause missed blocks, so you may be hopping around a few until you can find one that's suitable for a witness node.

If you want to learn more about witnesses and what they do, check out my article: https://steemit.com/witness-category/@someguy123/seriously-what-is-a-witness-why-should-i-care-how-do-i-become-one-answer

First, we install some basic dependencies (assuming you're on Ubuntu).

```
sudo apt update
sudo apt install git curl wget
```

Next, we download **Steem-in-a-box**, created by myself.

```
git clone https://github.com/Someguy123/steem-docker.git
cd steem-docker
```

Now that it's downloaded, and we're in the right folder, we can install Docker.

```
./run.sh install_docker
```

NOTE: If you're running this without root, you'll need to log out and back in again after it's done. Remember to `cd steem-docker` after logging back in.


Now, we download the pre-compiled STEEM image from DockerHub:
```
./run.sh install
```

A new feature in the HF19 Steem-in-a-box, automatically downloads blocks from @gtg's server, extracts them, and puts them in the right folder. This will take a while, but will dramatically speed up your setup time.

```
./run.sh dlblocks
```


### This next part is for witnesses, if you're wanting to run a seed, don't touch the config!

Open the wallet using a public server with the following command:

```
./run.sh remote_wallet
```



Create a key pair for your witness. 

```
suggest_brain_key
```

<center>![](https://steemitimages.com/DQmTEmx1VqqpY32hrYhfLJG9eHatb61wZwZj5qXTuHKpD2h/image.png)</center>

You should get something similar to this:

```
  "wif_priv_key": "5xxxxxxxxxxxxxxxxxxx",
  "pub_key": "STMxxxxxxxxxxxxxxxxx"
```

**Put the keys in notepad or something similar for the moment so you don't lose them.**

Press CTRL-D to exit the wallet.

Now, you need to decide on how much "shared memory" to give the server. Right now, 8GB is the bare minimum, however 12GB is recommended. DO NOT GIVE MORE SHARED MEMORY THAN YOU HAVE ACTUAL RAM AVAILABLE. e.g. if you have an 8GB VPS, only use 8G for your shared memory.

```
sudo ./run.sh shm_size 8G
```

<center>![](https://steemitimages.com/DQmQNZW3frXDx7d4hZqJm4XTmMMRQY1XAQty2boDKVR9BAo/image.png)</center>

Open up the config file in your favourite text editor, `nano` is good for beginners:

```
nano data/witness_node_data_dir/config.ini
```

You should not run a seed if you are a witness, so change

```
p2p-endpoint = 0.0.0.0:2001
```

to

```
# p2p-endpoint = 0.0.0.0:2001
```

This disables the seed.

On a blank line, put the following:

```
witness = "YOUR NAME GOES HERE WITHOUT THE @ SIGN"
private-key = 5xxxxxxxxxxxxx
```

Put in your witness name, and your private key from earlier. Be aware the name needs quotes, while the private key doesn't. You use the private key (wif_priv_key) you generated earlier and put into notepad.

You will also need to adjust `shared-file-size` to whatever size you decided earlier for the "shared memory". There should already be a line with 12G, adjust that, if you need to do not make a new line for this.

```
shared-file-size = 8G
```

Save and close the file (if using nano, press CTRL-X, say yes to saving)



Next, we adjust the steem-in-a-box settings so that it's named correctly, and to disable port forwarding for seeds:

```
nano .env
```

The file will be blank. In the file put the following:

```
PORTS=
DOCKER_NAME=witness
```

Again, save and close the file with CTRL-X.

Now, we can start up the witness server

```
./run.sh replay
```

Check the logs with this command:

```
./run.sh logs
```

You should see something similar to this:


```
344773ms th_a       application.cpp:297           startup              ] Replaying blockchain on user request.
344774ms th_a       database.cpp:151              reindex              ] Reindexing Blockchain
344823ms th_a       block_log.cpp:130             open                 ] Log is nonempty
344823ms th_a       block_log.cpp:139             open                 ] Index is nonempty
344823ms th_a       database.cpp:159              reindex              ] Replaying blocks...
344834ms th_a       database.cpp:2571             show_free_memory     ] Free memory is now 11G
   0.77369%   100000 of 12925066   (12282M free)
```

If you see lots of red error messages, something went wrong. You can ask for help debugging it in the [witness channel on 
 STEEMIT.CHAT](https://steemit.chat/channel/witness).

If it appears to be working, leave it for an hour or so. Check the logs every 10 minutes  until you see something like this:

```
1299055ms th_a       application.cpp:507           handle_block         ] Got 14 transactions on block 12928269 by pharesim -- latency: 55 ms
1302427ms th_a       application.cpp:507           handle_block         ] Got 18 transactions on block 12928270 by xeldal -- latency: 426 ms
1305291ms th_a       application.cpp:507           handle_block         ] Got 26 transactions on block 12928271 by arhag -- latency: 291 ms
1308045ms th_a       application.cpp:507           handle_block         ] Got 20 transactions on block 12928272 by pfunk -- latency: 45 ms
1311092ms th_a       application.cpp:507           handle_block         ] Got 23 transactions on block 12928273 by bhuz -- latency: 92 ms
```

This means your witness is now fully synced. 

Go to your profile on Steemit, click Wallet, then Permissions. Next to "Active Key" you should see "Login to show". Click that button and log in. Then press "Show private key", to reveal it. Make sure it begins with a "5".

Copy the key.

Now open the wallet with:

```
./run.sh wallet
```

![](https://steemitimages.com/DQmZo5cyxYrFiaz6X82qhu17CsTTbrHqf53pLp3CHFdc6xb/image.png)
(Image courtesy of @klye, copied from [his old guide](https://steemit.com/witness-category/@klye/the-complete-noob-guide-to-steem-witness-setup))

Set a password, unlock the wallet with the same password, then import your ACTIVE private key from steemit (NOT the one in notepad):

```
set_password "mysupersecurepass"
unlock "mysupersecurepass"
import_key 5zzzzzzzzzzzz
```

Finally, we can update/create the witness on the network. Replace the STMxxxx key with the public key you saved earlier in notepad, and replace YOURNAME with your witness name on Steemit.

```
update_witness "YOURNAME" "https://steemit.com/witness-category/@YOURNAME/my-witness-thread" "STMxxxxxxx" {"account_creation_fee":"0.200 STEEM","maximum_block_size":131072,"sbd_interest_rate":0} true
```

Assuming there are no big red messages, you're now a witness! :)

Go ahead, [vote for yourself](https://steemit.com/~witnesses) (and @someguy123).

### How do I know what rank I am?

Check SteemDB: https://steemdb.com/witnesses or steemd: https://steemd.com/witnesses

### What about a price feed?

As a witness, you're expected to run a price feed.

I recommend [Steemfeed-JS](https://steemit.com/witness-category/@someguy123/steemfeed-js-a-nodejs-price-feed-for-witneses), as it goes nicely with the docker set up.



---

Do you like what I'm doing for STEEM/Steemit?
----
[Vote for me to be a witness](https://steemit.com/~witnesses) - every vote counts. 
----
Don't forget to follow me for more like this.
----

---

Have you ever thought about being a witness yourself? Contact me on [STEEMIT.CHAT](https://steemit.chat/direct/someguy123), or just ask in the witness channel. I'm happy to guide you! Join in shaping the STEEM economy.

Are you looking for a new server provider? My company @privex offers highly-reliable and affordable dedicated and virtual servers for STEEM, LTC, and BTC! Contact me on [STEEMIT.CHAT](https://steemit.chat/direct/someguy123) for more information.

Are you looking for a Graphics designer for your project? Logos, PSD mockups, banners? Check out @MaliceRed - he posts about his life as a Freelance Graphics Designer, and is looking for work.