Installation Instructions - Omnicoin-Project/Omnicoin GitHub Wiki
Windows
1. Download Omnicoin
Omnicoin for Windows comes packaged as a zip file. At the moment, we only offer the full QT client for the wallet on Windows, and not the standalone daemon (omnicoind). You can download it from the Downloads Page.
2. Extract
Extract the files to a location of your choice. We recommend extracting it to C:\Program Files (x86)\Omnicoin.
3. Create a shortcut
In order to make the wallet easily accessible, you may want to create a desktop- or start menu shortcut to it. Doing so is as simple as right-clicking omnicoin-qt.exe and clicking on Send To > Desktop (as shortcut). In order to create a start menu shortcut, press Win-R (Win being the Windows key with a flag on it) and write: %AppData%\Microsoft\Windows\Start Menu\Programs. Now you just have to move or copy the desktop shortcut into the folder.
4. Configure the client
You can speed up synchronization of the blockchain by adding a couple of the official nodes. We already created a configuration file for you. Press Win-R again and write %AppData%. Copy omnicoin.conf into the folder and start Omnicoin.
Mac (Instructions coming soon)
Download from the Downloads Page
Linux
1. Install Dependencies
The first step is to update your system and then installing the software required by the Omnicoin daemon. You can do so using these simple commands:
sudo apt-get update; sudo apt-get upgrade
sudo apt-get install build-essential libboost-all-dev libdb++-dev git ca-certificates
2. Clone (download) Omnicoin
Next you will need to download the source code. When working with git repositories, this is known as "cloning". Again, this is pretty straight forward. The following command will clone the source code into a directory named "Omnicoin".
git clone https://github.com/Omnicoin-Project/Omnicoin.git
3. Build the daemon
Enter the directory we just downloaded the source code to using cd.
cd Omnicoin/src
Now, use make to actually compile the program. We tell make to use makefile.unix, which contains instructions for the program on how to compile it correctly. You can also specify USE_UPNP=- in order to compile the daemon without UPnP support. If you are going to run this on a server, you are not going to need it. If you do want UPnP support, simply change the minus (-) to a 1. If you want UPnP support, you will also need to install the libminiupnpc-dev.
make -f makefile.unix USE_UPNP=-
The strip command will remove a lot of debugging information from the executable, effectively reducing the file size a lot.
strip ./OmniCoind
Finally you can move or copy the executable to wherever you want it. If you want it to be available from all directories, you can copy it to the path folder for self-compiled software, like this:
sudo cp ./OmniCoind /usr/local/bin/OmniCoind
If you had trouble following this tutorial you should either try another tutorial or ask Doctor Blue.
Sample Configuration
================== This is the omnicoin.conf file, stored in your Omnicoin directory
Note: You do not need to have the rpcuser, rpcpassword, rpcport, server, or daemon lines. They are just there for example, and if you're just using it privately, it's strongly suggested that you remove them, leaving just the addnode lines.
rpcuser=OmnicoinUserNameChangeMePls
rpcpassword=PaSswordDON'tKEePThisAsThis
addnode=192.99.42.164
addnode=192.99.42.206
server=1
daemon=1
Wallet Locations
- Windows: %AppData%\Omnicoin\wallet.dat (Expanded to C:\Users\Username\AppData\Roaming\Omnicoin Usually)
- Mac: ~/Library/Application Support/Omnicoin/wallet.dat
- Linux: ~/.OmniCoin/wallet.dat
It is recommended that you backup your wallet, and store it in a safe place (e.g. a USB dongle or external drive)