updates the "Local" section of development docs to be more accurate so people don't run into the same snags I did. it wasn't immediately clear that .dev/ needed to be populated with the Core and Periphery configs and the DB needed to be run separately.
this is quite a bit of manual steps to get started and also to start every session (4 manual commands). i'd be happy to help with the DX here, but I don't want to move too many things at once, so just documenting the status quo for now.
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.
## 📋 Pull Request Information
**Original PR:** https://github.com/moghtech/komodo/pull/1240
**Author:** [@sloria](https://github.com/sloria)
**Created:** 3/11/2026
**Status:** 🔄 Open
**Base:** `2.0.0` ← **Head:** `dev-setup`
---
### 📝 Commits (1)
- [`3d7455b`](https://github.com/moghtech/komodo/commit/3d7455be5ab802fd1871aa4a039b85003ff69c8c) update local dev setup instructions
### 📊 Changes
**1 file changed** (+80 additions, -17 deletions)
<details>
<summary>View changed files</summary>
📝 `docsite/docs/ecosystem/development.md` (+80 -17)
</details>
### 📄 Description
updates the "Local" section of development docs to be more accurate so people don't run into the same snags I did. it wasn't immediately clear that `.dev/` needed to be populated with the Core and Periphery configs and the DB needed to be run separately.
this is quite a bit of manual steps to get started and also to start every session (4 manual commands). i'd be happy to help with the DX here, but I don't want to move too many things at once, so just documenting the status quo for now.
---
<sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
📋 Pull Request Information
Original PR: https://github.com/moghtech/komodo/pull/1240
Author: @sloria
Created: 3/11/2026
Status: 🔄 Open
Base:
2.0.0← Head:dev-setup📝 Commits (1)
3d7455bupdate local dev setup instructions📊 Changes
1 file changed (+80 additions, -17 deletions)
View changed files
📝
docsite/docs/ecosystem/development.md(+80 -17)📄 Description
updates the "Local" section of development docs to be more accurate so people don't run into the same snags I did. it wasn't immediately clear that
.dev/needed to be populated with the Core and Periphery configs and the DB needed to be run separately.this is quite a bit of manual steps to get started and also to start every session (4 manual commands). i'd be happy to help with the DX here, but I don't want to move too many things at once, so just documenting the status quo for now.
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.