The example shows how to compile the current github version of Monero, as of 06 Mar 2015, on Xubuntu 16.04 x64 Beta 1.
Note: Beta of Ubuntu 16.04 is not yet available. It will be released at the end of March.
Before proceeding with the compilation, the following packages are required:
# update Xubuntu's repository
sudo apt-get update
#install git to download latest Monero source code from github
sudo apt-get install git
# install dependencies to be able to compile Monero
sudo apt-get install build-essential cmake libboost-all-dev miniupnpc libunbound-dev graphviz doxygen
# or git and all dependencies in one command
# sudo apt-get install git build-essential cmake libboost-all-dev miniupnpc libunbound-dev graphviz doxygenHaving the dependencies, we can download the current github Monero version and compile it as follows:
# download the latest bitmonero source code from github
git clone https://github.com/monero-project/bitmonero.git
# go into bitmonero folder
cd bitmonero/
# compile
make # or make -j number_of_threads, e.g., make -j 2
# alternatively `make release` can be used instead of `make`. This compiles
# the source code without compiling unique tests which is faster, and can
# avid problems if there are compilation errors with compiling the testsPlease not that this is a current version of Monero on github, not the offical and stable release. Thus, as the development of Monero continues virtually on daily basis, sometimes things can break, including the compilation procedure provided. To avoid this, please use the source code and binary files of the offical and stable release of Monero which can be found here.
After successful compilation, the Monero binaries should be located in ./build/release/bin as shown below:
./build/release/bin/
├── bitmonerod
├── blockchain_converter
├── blockchain_dump
├── blockchain_export
├── blockchain_import
├── cn_deserialize
├── connectivity_tool
├── simpleminer
└── simplewalletI usually move the binaries into /opt/bitmonero/ folder. This can be done as follows:
# optional
sudo mkdir /opt/bitmonero
sudo mv -v ./build/release/bin/* /opt/bitmonero/This should result in:
/opt/bitmonero
├── bitmonerod
├── blockchain_converter
├── blockchain_dump
├── blockchain_export
├── blockchain_import
├── cn_deserialize
├── connectivity_tool
├── simpleminer
└── simplewalletNow we can start the Monero daemon, i.e., bitmonerod, and let it
download the blockchain and synchronize itself with the Monero network. After that, you can run your the simplewallet.
# launch the Monero daemon and let it synchronize with the Monero network
/opt/bitmonero/bitmonerod
# launch the Monero wallet
/opt/bitmonero/simplewalletbitmonerod and simplewallet do not have tab-compliton nor history.
This problem can be overcome using rlwrap.
# install rlwrap
sudo apt-get install rlwrap
# download bitmonerod and simplewallet commands files
wget -O ~/.bitmonero/monerocommands_bitmonerod.txt https://raw.githubusercontent.com/moneroexamples/compile-monero-09-on-xubuntu-16-04-beta-1/master/monerocommands_bitmonerod.txt
wget -O ~/.bitmonero/monerocommands_simplewallet.txt https://raw.githubusercontent.com/moneroexamples/compile-monero-09-on-xubuntu-16-04-beta-1/master/monerocommands_simplewallet.txt
# add aliases to .bashrc
echo "alias moneronode='rlwrap -f ~/.bitmonero/monerocommands_simplewallet.txt /opt/bitmonero/bitmonerod'" >> ~/.bashrc
echo "alias monerowallet='rlwrap -f ~/.bitmonero/monerocommands_bitmonerod.txt /opt/bitmonero/simplewallet'" >> ~/.bashrc
# reload .bashrc
source ~/.bashrcWith this, we can just start the daemon and wallet simply using
moneronode and monerowallet commands. rlwrap will provide
tab-complition and history for the monero programs.
If you want to develop your own C++11 programs on top of Monero 0.9, Monero's static libraries and headers will be needed. Below is shown how they can be setup for use to write your own C++11 programs based on Monero. An example of such a program is access-blockchain-in-cpp.
When the compilation finishes, a number of static Monero libraries should be generated. We will need them to link against in our C++11 programs.
Since they are spread out over different subfolders of the ./build/ folder, it is easier to just copy them into one folder. I assume that
/opt/bitmonero-dev/libs is the folder where they are going to be copied to.
# create the folder
sudo mkdir -p /opt/bitmonero-dev/libs
# find the static libraries files (i.e., those with extension of *.a)
# and copy them to /opt/bitmonero-dev/libs
# assuming you are still in bitmonero/ folder which you downloaded from
# github
sudo find ./build/ -name '*.a' -exec cp -v {} /opt/bitmonero-dev/libs \;This should results in the following file structure:
/opt/bitmonero-dev/
└── libs
├── libblockchain_db.a
├── libblocks.a
├── libcommon.a
├── libcrypto.a
├── libcryptonote_core.a
├── libcryptonote_protocol.a
├── libdaemonizer.a
├── libgtest.a
├── libgtest_main.a
├── liblmdb.a
├── libminiupnpc.a
├── libmnemonics.a
├── libotshell_utils.a
├── libp2p.a
├── librpc.a
└── libwallet.aNow we need to get Monero headers, as this is our interface to the
Monero libraries. Folder /opt/bitmonero-dev/headers is assumed
to hold the headers.
# create the folder
sudo mkdir -p /opt/bitmonero-dev/headers
# find the header files (i.e., those with extension of *.h)
# and copy them to /opt/bitmonero-dev/headers.
# but this time the structure of directories is important
# so rsync is used to find and copy the headers files
sudo rsync -zarv --include="*/" --include="*.h" --exclude="*" --prune-empty-dirs ./ /opt/bitmonero-dev/headersThis should results in the following file structure:
# only src/ folder with up to 3 level nesting is shown
/opt/bitmonero-dev/headers/src/
├── blockchain_db
│ ├── berkeleydb
│ │ └── db_bdb.h
│ ├── blockchain_db.h
│ ├── db_types.h
│ └── lmdb
│ └── db_lmdb.h
├── blockchain_utilities
│ ├── blockchain_utilities.h
│ ├── blocksdat_file.h
│ ├── bootstrap_file.h
│ ├── bootstrap_serialization.h
│ └── fake_core.h
├── blocks
│ └── blocks.h
├── common
│ ├── base58.h
│ ├── boost_serialization_helper.h
│ ├── command_line.h
│ ├── dns_utils.h
│ ├── http_connection.h
│ ├── i18n.h
│ ├── int-util.h
│ ├── pod-class.h
│ ├── rpc_client.h
│ ├── scoped_message_writer.h
│ ├── unordered_containers_boost_serialization.h
│ ├── util.h
│ └── varint.h
├── crypto
│ ├── blake256.h
│ ├── chacha8.h
│ ├── crypto.h
│ ├── crypto_ops_builder
│ │ ├── api.h
│ │ ├── crypto_int32.h
│ │ ├── crypto-ops.h
│ │ ├── crypto_sign.h
│ │ ├── crypto_uint32.h
│ │ ├── crypto_verify_32.h
│ │ ├── include
│ │ ├── ref10
│ │ ├── ref10CommentedCombined
│ │ └── sha512.h
│ ├── crypto-ops.h
│ ├── generic-ops.h
│ ├── groestl.h
│ ├── groestl_tables.h
│ ├── hash.h
│ ├── hash-ops.h
│ ├── initializer.h
│ ├── jh.h
│ ├── keccak.h
│ ├── oaes_config.h
│ ├── oaes_lib.h
│ ├── random.h
│ ├── skein.h
│ └── skein_port.h
├── cryptonote_config.h
├── cryptonote_core
│ ├── account_boost_serialization.h
│ ├── account.h
│ ├── blockchain.h
│ ├── blockchain_storage_boost_serialization.h
│ ├── blockchain_storage.h
│ ├── checkpoints_create.h
│ ├── checkpoints.h
│ ├── connection_context.h
│ ├── cryptonote_basic.h
│ ├── cryptonote_basic_impl.h
│ ├── cryptonote_boost_serialization.h
│ ├── cryptonote_core.h
│ ├── cryptonote_format_utils.h
│ ├── cryptonote_stat_info.h
│ ├── difficulty.h
│ ├── hardfork.h
│ ├── miner.h
│ ├── tx_extra.h
│ ├── tx_pool.h
│ └── verification_context.h
├── cryptonote_protocol
│ ├── blobdatatype.h
│ ├── cryptonote_protocol_defs.h
│ ├── cryptonote_protocol_handler_common.h
│ └── cryptonote_protocol_handler.h
├── daemon
│ ├── command_line_args.h
│ ├── command_parser_executor.h
│ ├── command_server.h
│ ├── core.h
│ ├── daemon.h
│ ├── executor.h
│ ├── p2p.h
│ ├── protocol.h
│ ├── rpc_command_executor.h
│ └── rpc.h
├── daemonizer
│ ├── daemonizer.h
│ ├── posix_fork.h
│ ├── windows_service.h
│ └── windows_service_runner.h
├── miner
│ ├── simpleminer.h
│ ├── simpleminer_protocol_defs.h
│ └── target_helper.h
├── mnemonics
│ ├── electrum-words.h
│ ├── english.h
│ ├── german.h
│ ├── italian.h
│ ├── japanese.h
│ ├── language_base.h
│ ├── old_english.h
│ ├── portuguese.h
│ ├── russian.h
│ ├── singleton.h
│ └── spanish.h
├── p2p
│ ├── net_node_common.h
│ ├── net_node.h
│ ├── net_peerlist_boost_serialization.h
│ ├── net_peerlist.h
│ ├── p2p_protocol_defs.h
│ └── stdafx.h
├── platform
│ ├── mingw
│ │ └── alloca.h
│ └── msc
│ ├── alloca.h
│ ├── inline_c.h
│ ├── stdbool.h
│ └── sys
├── rpc
│ ├── core_rpc_server_commands_defs.h
│ ├── core_rpc_server_error_codes.h
│ └── core_rpc_server.h
├── serialization
│ ├── binary_archive.h
│ ├── binary_utils.h
│ ├── crypto.h
│ ├── debug_archive.h
│ ├── json_archive.h
│ ├── json_utils.h
│ ├── serialization.h
│ ├── string.h
│ ├── variant.h
│ └── vector.h
├── simplewallet
│ ├── password_container.h
│ └── simplewallet.h
└── wallet
├── wallet2.h
├── wallet_errors.h
├── wallet_rpc_server_commands_defs.h
├── wallet_rpc_server_error_codes.h
└── wallet_rpc_server.hFull /opt/bitmonero-dev/ tree is here.
Other examples can be found on github. Please know that some of the examples/repositotires are not finished and may not work as intended.
Constructive criticism, code and website edits are always good. They can be made through github.
Some Monero are also welcome:
48daf1rG3hE1Txapcsxh6WXNe9MLNKtu7W7tKTivtSoVLHErYzvdcpea2nSTgGkz66RFP4GKVAsTV14v6G3oddBTHfxP6tU
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent