DUCSS/ducss-site

New DUCSS website

ducss-site

DUCSS website repository

Table of contents

1. Getting started
   1. Running the website locally
      1. Prerequisites
      2. Running the website
   2. Deploying to production
      1. Prerequisites
      2. Running the website

Getting started

Running the website locally

Prerequisites

You will need to have installed:

1. Docker

Running the website

1. Clone the repo

   git clone https://github.com/DUCSS/ducss-site.git
   

2. Navigate into the cloned GitHub repository

   cd ducss-site
   

3. Copy .env.example to .env and change HOST, PORT, CORS_ORIGIN_URL, MONGODB_PORT, MONGODB_URL, SERVER_PORT_HTTP, SERVER_PORT_HTTPS, USERNAME and PASSWORD
4. Run the start script using ./start_dev.sh

The local website will be hosted on http://localhost:<PORT> and the api will be hosted on http://localhost:<SERVER_PORT_HTTP>

Deploying to production

Prerequisites

You will need to have installed:

1. Docker
2. NGINX
3. Certbot

Running the website

1. Get a certificate for the domain ducss.ie, instructions are found here
2. Clone the repo

   git clone https://github.com/DUCSS/ducss-site.git
   

3. Navigate into the cloned GitHub repository

   cd ducss-site
   

4. Copy nginx.conf to /etc/nginx/nginx.conf

   cp ./nginx.conf /etc/nginx/nginx.conf
   

5. Copy .env.example to .env and change HOST, PORT, CORS_ORIGIN_URL, MONGODB_PORT, MONGODB_URL, SERVER_PORT_HTTP, SERVER_PORT_HTTPS, USERNAME and PASSWORD
6. Run the start script using ./start.sh

The website will be hosted on https://ducss.ie and the api will be hosted on https://ducss.ie:<SERVER_PORT_HTTPS>