mirror of
https://github.com/SrIzan10/hc-harbor.git
synced 2026-05-01 10:45:21 +00:00
61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
# Hackatime!
|
|
|
|
[](https://status.hackatime.hackclub.com/status/hackatime)
|
|
[](https://status.hackatime.hackclub.com/status/hackatime)
|
|
[](https://hackatime-badge.hackclub.com)
|
|
|
|
## Local development
|
|
|
|
```sh
|
|
# Set it up...
|
|
$ git clone https://github.com/hackclub/harbor && cd harbor
|
|
|
|
# Set your config
|
|
$ cp .env.example .env
|
|
```
|
|
|
|
Edit your `.env` file to include the following:
|
|
|
|
```env
|
|
# Database configurations - these work with the Docker setup
|
|
DATABASE_URL=postgres://postgres:secureorpheus123@db:5432/app_development
|
|
WAKATIME_DATABASE_URL=postgres://postgres:secureorpheus123@db:5432/app_development
|
|
SAILORS_LOG_DATABASE_URL=postgres://postgres:secureorpheus123@db:5432/app_development
|
|
|
|
# Generate these with `rails secret` or use these for development
|
|
SECRET_KEY_BASE=alallalalallalalallalalalladlalllalal
|
|
ENCRYPTION_PRIMARY_KEY=32characterrandomstring12345678901
|
|
ENCRYPTION_DETERMINISTIC_KEY=32characterrandomstring12345678902
|
|
ENCRYPTION_KEY_DERIVATION_SALT=16charssalt1234
|
|
```
|
|
|
|
Comment out the `LOOPS_API_KEY` for the local letter opener, otherwise the app will try to send out a email and fail.
|
|
|
|
## Build & Run the project
|
|
|
|
```sh
|
|
$ docker compose run --service-ports web /bin/bash
|
|
|
|
# Now, setup the database using:
|
|
app# bin/rails db:create db:schema:load db:seed
|
|
|
|
# Now start up the app:
|
|
app# bin/rails s -b 0.0.0.0
|
|
# This hosts the server on your computer w/ default port 3000
|
|
|
|
# Want to do other things?
|
|
app# bin/rails c # start an interactive irb!
|
|
app# bin/rails db:migrate # migrate the database
|
|
```
|
|
|
|
You can now access the app at http://localhost:3000/
|
|
|
|
Use email authentication from the homepage with `test@example.com` or create a new user (you can view outgoing emails at http://localhost:3000/letter_opener)!
|
|
|
|
Ever need to setup a new database?
|
|
|
|
```sh
|
|
# inside the docker container, reset the db
|
|
app# $ bin/rails db:drop db:create db:migrate db:seed
|
|
```
|