diff --git a/README.md b/README.md
index 47c121361..397f7fa01 100644
--- a/README.md
+++ b/README.md
@@ -26,43 +26,55 @@ We're building our community on Discord. [Join us!](https://discord.gg/nyqRrjujN
 
 ## How to setup local development
 
-The easiest way to get started with local development is to run our docker-compose file which will run
-postgres, our web frontend and an API server.. Along with docker-compose you will need to run our `pupeteer-parse` service. This service is used to fetch web page content.
+The easiest way to get started with local development is to use `docker-compose up`. This will start a postgres container, our web frontend, and an API server.
+
+Along with docker-compose you will need to run our `pupeteer-parse` service. This service is used to
+fetch web page content and relies on pupeteer and chromium which currently do not run inside of
+docker.
 
 ###  Running the web and API services
-1. In the root directory run
 
-`docker-compose up`
+### 1 Start docker-compose
 
+```bash
+git clone https://github.com/omnivore-app/omnivore
+cd omnivore
+docker-compose up
+```
 This will start postgres, initialize the database, and start the web and api services.
 
-2. Open a browser and go to `http://localhost:3000`
+### 2. Open the browser
 
-3. To create a test account and login visit `http://localhost:3000/email-registration` and sign up.
+Open <http://localhost:3000> and confirm Omnivore is running
+
+### 3. Create a test account
+
+Omnivore uses social login for most users. But for testing there is an email + password 
+option. 
+
+Open a browser and go to <http://localhost:3000/email-registration>
 
 ### Running the pupeteer-parse service
 
-1. Install and configure Chromium
+### 1. Install and configure Chromium
+
+If you are using an M1 Mac:
 
 ```
-brew install chromium
+brew install chromium --no-quarantine
 export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
-export PUPPETEER_EXECUTABLE_PATH=`which chromium`
+export CHROMIUM_PATH=/opt/homebrew/bin/chromium
 ```
 
-1. Navigate to the service directory
+### 2. Navigate to the service directory, setup your env file, and install dependencies
 
 ```
 cd packages/puppeteer-parse
-```
-
-2. Run `yarn` to install dependencies
-
-```
+cp .env.example .env
 yarn
 ```
 
-3. Start the service
+### 3. Start the service
 
 ```
 yarn start
@@ -70,12 +82,10 @@ yarn start
 
 This will start the puppeteer-parse service on port 9090.
 
-
 In your browser navigate to http://localhost:3000/home click the `Add Link` button and enter a URL
 such as https://blog.omnivore.app/p/getting-started-with-omnivore
 
-You should see a Chromium window open and navigate to your link. When the service is done fetching
-your content you will see it in your library.
+You should see a Chromium window open and navigate to your link. When the service is done fetching your content you will see it in your library.
 
 
 ## How to deploy to your own server
diff --git a/packages/puppeteer-parse/.env.example b/packages/puppeteer-parse/.env.example
index 8859b9b35..64242a22d 100644
--- a/packages/puppeteer-parse/.env.example
+++ b/packages/puppeteer-parse/.env.example
@@ -1,17 +1,8 @@
-# Should match with the JWT_SECRET that the backend uses
+# Should match with the JWT_SECRET that the api uses
 JWT_SECRET=some_secret
+
 # Address of the backend that is running locally
 REST_BACKEND_ENDPOINT=http://localhost:4000/api
-# Path to the chromium for puppeteer to use locally
-CHROMIUM_PATH=/usr/local/bin/chromium
-IS_LOCAL=true
 
-PREVIEW_IMAGE_BUCKET=omnivore-dev-preview-bucket
-# This var enables Default Application Credential to get access to the Google Cloud Storage
-# Either provide a path to your own service account JSON file that has acccess to the GCS, or download one from 1Password here:
-# https://start.1password.com/open/i?a=4255G5NBWZATRNORAU5VYYKQZM&v=pxajy5r4f5cypesaw4c4g5hc2q&i=5fduj37zk5em7meuwglkq3p4my&h=fluxon.1password.com
-GOOGLE_APPLICATION_CREDENTIALS=./omnivore-app-287712-d420b283ee86.sa.json
-# Origins that preview image creation service has access to
-# Might include few values separated by comma: "http://a,http://b, ..."
-ALLOWED_ORIGINS='http://localhost:3000'
-PREVIEW_IMAGE_CDN_ORIGIN='https://preview-dev.omnivore-image-cache.app'
+# set for local development
+IS_LOCAL=true