Getting started

This guide helps you get started running and interacting with a local development server and tests.

See also Bloom's setup wiki.

Installing packages

Install node

NOTE: At the time of editing, this project requires Node 14.

• Make sure you have node installed with npm -v
• Install node if you don't have it. You may want to use nvm if you need access to multiple versions. Here is a super helpful link on installing node without sudo.

Install yarn

• Check if you have yarn installed with yarn -v
• If you don't have yarn, install with npm install --global yarn

Setting up the repo and database

Cloning the repository

1. Join GitHub.

2. Install git on your machine.

3. Clone the repository.

   Run this in your terminal (and/or refer to this guide):

   git clone [email protected]:CityOfDetroit/bloom.git
   

4. Configure the upstream repo:

   git remote add upstream https://github.com/bloom-housing/bloom.git
   

5. In backend/core, copy .env.template into .env

6. Copy sites/public/.env.template and sites/partners/.env.template to their respective .env files.

7. Run yarn install:all from the main directory, which will run yarn install at both the top level and in backend/core.

Set up database

For managing redis and postgres, you need to decide whether to:

• Install and use directly on your machine
• Install and use Docker containers

Install directly

Install and set up postgres

1. Install PostgreSQL

• On Linux, you can follow these steps.
• If you are hoping to rely on your username with sudo -u postgres createuser your_username -s, you'll need to edit your pg_hba.conf to trust local connections to the db.
• Otherwise, you can create a user WITH a password (like bloom-dev, password bloom1) and put that in your .env:

  sudo -u postgres psql
  CREATE USER lemmy WITH PASSWORD 'myPassword';
  

• Restart the service afterward: sudo service postgresql restart

1. Verify you have a postgres server running (this should happen automatically in the last step) with psql postgres. This should launch you into a psql shell, which you can exit with \quit.
2. Create a database with a name matching your username:

$ psql postgress
postgres=# CREATE DATABASE your_username_here;
postgres=# \quit

Install redis

1. Install Redis
2. Open a terminal and start a redis server with redis-server.
3. To check that the server is running, open another terminal and run redis-cli ping.

Use Docker containers

1. Install Docker

2. Install Docker Compose

3. Install psql globally

   • sudo apt-get install postgresql-client

4. Add these lines to your ~/.bashrc file for authentication to the postgres container as the correct user:

   export PGUSER=postgres
   export PGPASSWORD=postgres
   

5. Change the DATABASE_URL line in your .env to be:

   DATABASE_URL=postgres://localhost:5432/bloom
   

6. Navigate to the bloom directory that you created when you cloned the repo and run the following:

   docker-compose up redis postgres
   

   • You should see some output indicating that the containers have successfully started.

   • If you wish to stop running the services, you can Ctl-C to kill the processes.

   • If you wish to run the containers in the background and not need to keep the terminal open, kill the previous containers and run:

     docker-compose up -d redis postgres
     

     You can stop running the containers in the background via docker-compose down

Seeding the database

1. To seed the database with a variety of listings (including CA listings), cd backend/core and yarn db:reseed.

   • For Detroit-only listings, use yarn db:reseed:detroit.
   • psql may give you permissions issues here. Locally you can give yourself superuser permissions as a workaround.
   • Some installations of psql use a different default port value. If psql gives error messages about socket 5433, try adding export PGPORT=5432 to your ~/.bashrc.

2. Check that you can connect to the bloom database and run a simple query:

   $ psql bloom
   bloom=# select count(*) from units;