Skip to content
Dojo Open Source Project
Releases

Viewing and editing configuration files

After you have installed Dojo, you may have a need to view your existing configuration files (e.g. if you want to copy one of your admin credentials), or you may want to edit a configuration file to configure your Dojo for a more advanced setup.

This guide does not provide details of how to go about setting configurations files for specific advanced Dojo setups, only how you would go about editing/saving configuration files, then how to apply the changes.

In the terminal of your Dojo, copy and paste the following commands, then press ENTER.

How to view configuration files

Section titled “How to view configuration files”
Section titled “Navigate to the configuration files directory”
Terminal window
cd ~/dojo-app/docker/my-dojo/conf/

This is the directory where all Dojo configuration (conf) files are stored. All the following commands are to be run in this directory.

View bitcoind conf

Section titled “View bitcoind conf”
Terminal window
cat docker-bitcoind.conf

View common conf

Section titled “View common conf”
Terminal window
cat docker-common.conf

View explorer conf

Section titled “View explorer conf”
Terminal window
cat docker-explorer.conf

View indexer conf

Section titled “View indexer conf”
Terminal window
cat docker-indexer.conf

View mysql conf

Section titled “View mysql conf”
Terminal window
cat docker-mysql.conf

View node conf

Section titled “View node conf”
Terminal window
cat docker-node.conf

View tor conf

Section titled “View tor conf”
Terminal window
cat docker-tor.conf

How to edit configuration files

Section titled “How to edit configuration files”

Note: This guide only applies if you have already installed Dojo.

Section titled “Navigate to the configuration files directory”
Terminal window
cd ~/dojo-app/docker/my-dojo/conf/

This is the directory where all Dojo configuration (conf) files are stored.

Open the configuration file in the editor

Section titled “Open the configuration file in the editor”

Run the following command, substituting in the name of the configuration file you wish to edit:

Terminal window
nano docker-ConfigurationFileNameHere.conf

For example:

Terminal window
nano docker-indexer.conf

Make your desired edits

Section titled “Make your desired edits”

Continue to make edits to the configuration file which you hare opened in the editor.

Top tips for editing configuration files

Section titled “Top tips for editing configuration files”
  • Do not use your mouse
  • Use your keyboard UP, DOWN, LEFT, RIGHT, HOME, and END buttons to navigate
  • Use your keyboard BACKSPACE button to delete text
  • Paste using ctrl + shift + v
  • If you make a mistake, go:
    • ctrl + x
    • then press n
    • then press ENTER
    • then enter the “nano” command into the terminal to try again

Save and exit the configuration file

Section titled “Save and exit the configuration file”

Type the following into your keyboard:

  • ctrl + x
  • then press y
  • then press ENTER ¨
Section titled “Navigate to the Dojo script directory”
Terminal window
cd ~/dojo-app/docker/my-dojo

Run “upgrade” command to apply changes

Section titled “Run “upgrade” command to apply changes”
Terminal window
./dojo.sh upgrade

Note: any changes made to configuration files will not be applied until you run this upgrade command.

Once you see a constant stream of “node.js”, “bitcoind”, and “fulcrum” logs, your configuration changes have successfully been applied.

To exit the log screen, go: ctrl + c