Install CHORDS For Various Operating Systems

  sudo -i
  apt-get install docker.io docker-compose git python-pip
  
mkdir -p /var/lib/chords
cd /var/lib/chords

# Fetch the control script:
pip3 install sh
curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/development/chords_control

# Initial installation:
python3 chords_control --config
python3 chords_control --update

# To run CHORDS:
python3 chords_control --run

# To stop CHORDS:
python3 chords_control --stop

# To reconfigure and update:
cd /var/lib/chords
python3 chords_control --renew
python3 chords_control --config
python3 chords_control --update
python3 chords_control --stop
python3 chords_control --run
Now point your browser at the IP of the the system. localhost will often work as the IP, if the browser is on the same system. Be sure to use http:// (not https://).
  sudo -i # Or 'su -' if you do not have sudo privileges
  yum -y install epel-release
  yum -y install docker docker-compose
  yum -y install git
  yum -y install python3-pip
  systemctl enable docker
  systemctl start docker
  
mkdir -p /var/lib/chords
cd /var/lib/chords

# Fetch the control script:
pip3 install sh
curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/development/chords_control

# Initial installation:
python3 chords_control --config
python3 chords_control --update

# To run CHORDS:
python3 chords_control --run

# To stop CHORDS:
python3 chords_control --stop

# To reconfigure and update:
cd /var/lib/chords
python3 chords_control --renew
python3 chords_control --config
python3 chords_control --update
python3 chords_control --stop
python3 chords_control --run
Now point your browser at the IP of the the system. localhost will often work as the IP, if the browser is on the same system. Be sure to use http:// (not https://).
  1. Make sure you have Python 3 for Mac</a>.
  2. Verify that python is working:
     
      python3
      Python 3.9.12 (main, Mar 26 2022, 15:51:15)  
      [Clang 13.1.6 (clang-1316.0.21.2)] on darwin
      Type "help", "copyright", "credits" or "license" for more information.
      >>> quit()
      
  3. Install Docker for Mac.
  4. Run Docker. Configure its preferences to start Docker automatically.
  5. Note when you see the whale in the menu bar (upper right corner of your screen) docker is up and running!
  6. Open a command window, and verify that docker is working:
     
      docker run hello-world
      Hello from Docker!
      This message shows that your installation appears to be working correctly.
      ...
     
  7. Then in a terminal window:
      mkdir chords
      cd chords
    
      # Fetch the control script:
      pip3 install sh
      curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/development/chords_control
    
      # Make sure the "future" module is installed
      pip3 install future
    
      # Initial installation:
      python3 chords_control --config
      python3 chords_control --update
    
      # To run CHORDS:
      python3 chords_control --run
    
      # To stop CHORDS:
      python3 chords_control --stop
    
      # To reconfigure and update:
      cd chords
      python3 chords_control --renew
      python3 chords_control --config
      python3 chords_control --update
      python3 chords_control --stop
      python3 chords_control --run
      
  8. Once the above script has been run all you need to do to start chords on your computer again is open the terminal and type
  9.   cd chords
      python3 chords_control -- run
      
Now point your browser at the IP of the the system. localhost will often work as the IP, if the browser is on the same system. Be sure to use http:// (not https://).
  1. Open a command window and create a directory for chords files. The name and location are not important, but we suggest that you name it 'chords', and create it in your home directory.
  2.   mkdir chords
      
  3. Download and extract curl. Copy the files (curl.exe, etc.) in the 'curl.xxx/bin/' directory to your chords directory. For help with curl, visit this video.
  4. Download the Windows python3 2 installer. Double click on the downloaded .msi file to install it.
  5. Add Python3 paths to the Path environment variable. Hints:
    • Open the Start Search, type in “env”, and choose “Edit the system environment variables”
    • Click the “Environment Variables…” button.
    • Under the "User Variables” section (the upper half), find the row with “Path” in the first column. Click "Edit". “Edit environment variable” will appear.
    • Select "New", and enter the Python3 directory. This will usually be C:\Python27.
    • Select "New", and enter the Python3 scripts directory. This will usually be C:\Python27\scripts.
    • Save your changes
  6. Verify that python is working:
     
      python3
      Python 3.9.7 (tags/v3.9.7:1016ef3, Aug 30 2021, 20:19:38) [MSC v.1929 64 bit (AMD64)] on win32
      Type "help", "copyright", "credits" or "license" for more information.
      >>> quit()
      
  7. Install Docker Desktop for Windows. (You will be required to create a free docker hub account, and log into it.)
  8. Run the Docker Desktop. It may take a minute to start up.
  9. Open a command window, and verify that docker is working:
     
      docker run hello-world
      Hello from Docker!
      This message shows that your installation appears to be working correctly.
      ...
     
  10. Install CHORDS from the command window:
      cd chords
    
    # Fetch the control script:
    curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords//development/chords_control
    
    # Initial installation:
    python3 chords_control --config
    python3 chords_control --update
    
    # To run CHORDS:
    python3 chords_control --run
    
    # To stop CHORDS:
    python3 chords_control --stop
    
    # To reconfigure and update:
    cd chords
    python3 chords_control --renew
    python3 chords_control --config
    python3 chords_control --update
    python3 chords_control --stop
    python3 chords_control --run
      
  11. Once the above script has been run all you need to do to start chords on your computer again is open the terminal and type
  12.   cd chords
      python3 chords_control -- run
      
Now point your browser at the IP of the the system. localhost will often work as the IP, if the browser is on the same system. Be sure to use http:// (not https://).


When you first start up your CHORDS portal don’t panic if you get 502 error. It’s a good sign! Just hit refresh on your browser until your portal shows up. See the detailed instructions if the Quick Start recipes are not adequate to get your portal running, and for additional information.

Continue to Portal Configuration