curl https://sh.rustup.rs -sSf | sh; source $HOME/.cargo/env)
The latest Kepler release can be found on the project Release Page. Binaries are currently provided for Linux and OSX.
Distribution-specific releases will likely appear over time, and will be listed here.
Download the zipped binary to your machine, and unzip it using the terminal. This will unzip a single file called
kepler, which contains both the server and wallet software.
For now, we'd recommend placing this somewhere relative to your home
directory, and editing your path environment variable to ensure the
kepler executable is available from wherever you run it. All of this can be
done by running the following commands in the directory to which you
mkdir -p ~/kepler tar xzf kepler-v1.0.0-479973573-linux-amd64.tgz -C ~/kepler echo export 'PATH=~/kepler:$PATH' >> ~/.bashrc source ~/.bashrc
After following the installation steps, simply run Kepler:
Or, to run a Floonet (i.e. test network) node:
And that is it! The Kepler TUI (Text-User-Interface) should appear and your node should automatically sync up with the blockchain.
By default, your Kepler node keeps all of its configuration files and data in the
~/.kepler directory under your user home. The main server configuration file can be found in the file
~/.kepler/floo/kepler-server.toml for Floonet). This file is fully documented, and contains many
configuration options for your Kepler server. Leaving these values at
their defaults should work for most people who simply want to run a
You can also keep Kepler's data and configuration files in a custom directory. From the directory in which you want Kepler to store its files, run:
kepler server config
This will create a
kepler-server.toml file in the current directory that is configured to place its data files in the same directory. The
kepler command will always check the current directory for a
kepler-server.toml file, and if one is found it will use it instead of
You can view further details on the various commmand-line options available from kepler using the help command:
kepler help kepler client help kepler server help