Install CHORDS For Various Operating Systems

Ubuntu
RHEL & Centos
Mac
W10

  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==1.14.3
curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/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==1.14.3
curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/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://).

Make sure you have Python 3 for Mac</a>.

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()

Install Docker for Mac.
Run Docker. Configure its preferences to start Docker automatically.
Note when you see the whale in the menu bar (upper right corner of your screen) docker is up and running!

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.
  ...

Then in a terminal window:

  mkdir chords
  cd chords

  # Fetch the control script:
  pip3 install sh==1.14.3
  curl -O -k https://raw.githubusercontent.com/earthcubeprojects-chords/chords/master/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

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

  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://).

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.

  mkdir chords

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.
Download the Windows python3 2 installer. Double click on the downloaded .msi file to install it.
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

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()

Install Docker Desktop for Windows. (You will be required to create a free docker hub account, and log into it.)
Run the Docker Desktop. It may take a minute to start up.

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.
  ...

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:
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

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

  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