docs: add dev containers config gotcha in README #479

Merged
nshki merged 3 commits from docs/improve-devcontainer-setup-config into main 2024-02-26 19:46:45 +08:00
nshki commented 2024-02-25 01:26:29 +08:00 (Migrated from github.com)

Overview

This is a small README update for devs who choose to use dev containers to work on the project. When setting this up on my machine (Fedora Asahi Linux running on an M2 MacBook Air) via the dev containers CLI, I ran into an issue where the Rails server kept throwing a could not connect to server: Cannot assign requested address error. The issue was that the .env file that I copied from .env.example was trying to connect to DB_HOST=localhost when it needed to be pointed at DB_HOST=db in the Docker Compose setup.

This adds a sentence in the README to address this and it also adds a comment in .env.example next to the relevant line.

And as a side note, I'm very excited that you all have decided to open source this lovely project. I'm looking forward to keeping up with its developments and would love to contribute when I can.

# Overview This is a small README update for devs who choose to use dev containers to work on the project. When setting this up on my machine (Fedora Asahi Linux running on an M2 MacBook Air) via the [dev containers CLI](https://github.com/devcontainers/cli), I ran into an issue where the Rails server kept throwing a `could not connect to server: Cannot assign requested address` error. The issue was that the `.env` file that I copied from `.env.example` was trying to connect to `DB_HOST=localhost` when it needed to be pointed at `DB_HOST=db` in the Docker Compose setup. This adds a sentence in the README to address this and it also adds a comment in `.env.example` next to the relevant line. And as a side note, I'm very excited that you all have decided to open source this lovely project. I'm looking forward to keeping up with its developments and would love to contribute when I can.
zachgoll (Migrated from github.com) approved these changes 2024-02-26 19:46:33 +08:00
zachgoll (Migrated from github.com) left a comment

Good idea, this is always a tricky thing to remember when setting up with Docker!

Good idea, this is always a tricky thing to remember when setting up with Docker!
Sign in to join this conversation.