Skip to content

WIP: Fix dev setup documentation - #65

Open
colado wants to merge 9 commits into
podverse:v5-developfrom
colado:fix-dev-setup-documentation
Open

WIP: Fix dev setup documentation#65
colado wants to merge 9 commits into
podverse:v5-developfrom
colado:fix-dev-setup-documentation

Conversation

@colado

@colado colado commented Dec 20, 2025

Copy link
Copy Markdown

This PR introduces some enhancements to the dev setup process:

  • Adds some missing vars and values to some of the env.example files.
  • Adds a couple minor changes to the local setup documentation.
  • Makes a couple of enhancements to the link script to avoid some pitfalls I ran into while trying to run it.
  • Aligns the docker compose file with the new v18+ layout.

@colado
colado changed the base branch from master to v5-develop December 20, 2025 19:59
@colado colado changed the title Add missing env.example file WIP: Fix dev setup documentation Dec 20, 2025
@colado
colado marked this pull request as draft December 21, 2025 11:33
@mitchdowney

Copy link
Copy Markdown
Member

I know it's WIP, but changes are looking good. Thanks for your help!

- podverse_local_network
volumes:
- podverse_local_db_data:/var/lib/postgresql/data
- podverse_local_db_data:/var/lib/postgresql

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good to know. Thanks!

@colado

colado commented Dec 23, 2025

Copy link
Copy Markdown
Author

Thanks @mitchdowney. I got everything to run locally. Just one more thing: in order to get the dummy data I had to sign up to Podcast Index and paste the keys on the env files of podverse-qa and podverse-workers (in order to run the make local_qa_init_data/npm run parser... commands respectively). The parser did run for quite a while so not sure if I was overdoing this part or that's how it's supposed to be? Once I understand this part better I could maybe add a couple lines in the doc to make it more clear.

Also I did have to change some of the values on the podverse-api's env file for it to connect to postgres successfully. Other than that everything worked :)

@colado
colado marked this pull request as ready for review January 2, 2026 04:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants