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:
pip install sh
curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/chords_control

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

# To run CHORDS:
python chords_control --run

# To stop CHORDS:
python chords_control --stop

# To reconfigure and update:
cd /var/lib/chords
curl -O -k  https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/chords_control
python chords_control --config
python chords_control --update
python chords_control --stop
python 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 python2-pip
  systemctl enable docker
  systemctl start docker
  
mkdir -p /var/lib/chords
cd /var/lib/chords

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

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

# To run CHORDS:
python chords_control --run

# To stop CHORDS:
python chords_control --stop

# To reconfigure and update:
cd /var/lib/chords
curl -O -k  https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/chords_control
python chords_control --config
python chords_control --update
python chords_control --stop
python 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 2.7 for Mac.
  2. Verify that python is working:
     
      python
      Python 2.7.16 (v2.7.16:413a49145e, Mar  4 2019, 01:37:19) [MSC v.1500 64 bit (AMD64)] on win32
      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:
      pip install sh
      curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/chords_control
    
      # Initial installation:
      python chords_control --config
      python chords_control --update
    
      # To run CHORDS:
      python chords_control --run
    
      # To stop CHORDS:
      python chords_control --stop
    
      # To reconfigure and update:
      cd chords
      curl -O -k  https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/chords_control
      python chords_control --config
      python chords_control --update
      python chords_control --stop
      python 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
      python 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 Python 2 installer. Double click on the downloaded .msi file to install it.
  5. Add Python 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 Python directory. This will usually be C:\Python27.
    • Select "New", and enter the Python scripts directory. This will usually be C:\Python27\scripts.
    • Save your changes
  6. Verify that python is working:
     
      python
      Python 2.7.16 (v2.7.16:413a49145e, Mar  4 2019, 01:37:19) [MSC v.1500 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/master/chords_control
    
    # Initial installation:
    python chords_control --config
    python chords_control --update
    
    # To run CHORDS:
    python chords_control --run
    
    # To stop CHORDS:
    python chords_control --stop
    
    # To reconfigure and update:
    cd chords
    python chords_control --renew
    python chords_control --config
    python chords_control --update
    python chords_control --stop
    python 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
      python 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