InstallationΒΆ

  1. ColdFront requires Python 3.6, memcached, and redis.
  • CentOS (7.5)
sudo yum install epel-release
sudo yum install python36 python36-devel memcached redis
  • Ubuntu (16.04)
sudo add-apt-repository ppa:jonathonf/python-3.6
sudo apt-get update
sudo apt-get install python3.6 python3.6-venv memcached redis-server
  1. Clone ColdFront in a new directory and create a Python virtual environment for Coldfront
mkdir coldfront_app
cd coldfront_app
git clone https://github.com/ubccr/coldfront.git
python3.6 -mvenv venv
  1. Activate the virtual environment and install the required Python packages
source venv/bin/activate
cd coldfront
pip install wheel
pip install -e .
  1. Copy config/local_settings.py.sample to config/local_settings.py.
cp coldfront/config/local_settings.py.sample coldfront/config/local_settings.py
  • Open config/local_settings.py and update the following:
    • Update SECRET_KEY. Consider making the length at least 50 characters long.
    • Update TIME_ZONE if necessary
  1. Copy config/local_strings.py.sample to config/local_strings.py and update if desired.
cp coldfront/config/local_strings.py.sample coldfront/config/local_strings.py
  1. Run initial setup
coldfront initial_setup
  1. Optional: Add some test data
coldfront load_test_data
  1. Start development server
coldfront runserver 0.0.0.0:8000
  1. Point your browser to http://localhost:8000
  • You can log in as admin with password test1234.
  • You can log in as a PI using username ccollins with password test1234.
  • You can log in as center director using username michardson with password test1234.
  • Password for all users is also teset1234.