Comprehensive local development infrastructure for VoIP services on Apple Silicon (M Series Processors) using Colima
Repo NormB/devstack-core, read from GitHub 12 h ago. NormB has not joined Take My Repo.
NormB/devstack-core is a public repo on GitHub by NormB. Comprehensive local development infrastructure for VoIP services on Apple Silicon (M Series Processors) using Colima. It declares the MIT license on GitHub. It is written mainly in Shell, has 0 stars and last changed on 2026-11-19. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Complete Docker-based development infrastructure for Apple Silicon Macs, optimized with Colima
A comprehensive, self-contained development environment providing Git hosting (Forgejo), databases (PostgreSQL, MySQL, MongoDB), caching (Redis Cluster), message queuing (RabbitMQ), secrets management (Vault), and observability (Prometheus, Grafana, Loki) - all running locally on your Mac.
Get up and running in 10 minutes (5 minutes if prerequisites already installed):
# 1. Install prerequisites
brew install colima docker docker-compose uv
# 2. Clone and setup
git clone https://github.com/NormB/devstack-core.git ~/devstack-core
cd ~/devstack-core
# 3. Install Python dependencies
uv venv && uv pip install -r scripts/requirements.txt
# 4. Configure environment
cp .env.example .env
# 5. Start with standard profile (recommended)
./devstack start --profile standard
# 6. Initialize Vault (first time only)
./devstack vault-init # Creates Vault, generates unseal keys
./devstack vault-bootstrap # Enables AppRole, generates credentials & certificates
# 7. Initialize Redis cluster (first time only, for standard/full profiles)
./devstack redis-cluster-init
# 8. Verify everything is running
./devstack health
Access your services:
Required:
Software (auto-installed via Homebrew):
For development:
Choose the profile that fits your needs:
| Profile | Services | RAM | Use Case |
|---|---|---|---|
| minimal | 5 services | 2GB | Git hosting + essential development (single Redis) |
| standard | 10 services | 4GB | Full development stack + Redis cluster (RECOMMENDED) |
| full | 18 services | 6GB | Complete suite + observability (Prometheus, Grafana, Loki) |
| reference | +5 services | +1GB | Educational API examples (combine with standard/full) |
# Start with different profiles
./devstack start --profile minimal # Lightweight
./devstack start --profile standard # Recommended
./devstack start --profile full # Everything
# Combine profiles for reference apps
./devstack start --profile standard --profile reference
# Check what's running
./devstack status
./devstack health
See Service Profiles Guide for detailed information.
DevStack Core implements AppRole authentication for secure, zero-trust credential management across all core services.
AppRole is HashiCorp Vault's recommended authentication method for applications. Instead of hardcoding secrets or using a single root token, each service authenticates using its own role-id (identifies the service) and secret-id (proves authorization).
Security Benefits:
When you run ./devstack vault-bootstrap, the system:
~/.config/vault/approles/<service>/✅ Core Services (AppRole Enabled - 7 services):
⚠️ Infrastructure Services (Root Token - 9 services):
Migration Roadmap: Phase 4+ will migrate remaining services to AppRole for 95%+ coverage.
Each AppRole-enabled service follows this flow:
# 1. Container starts with init-approle.sh wrapper script
# 2. Script reads credentials from mounted volume
role_id=$(cat /vault-approles/<service>/role-id)
secret_id=$(cat /vault-approles/<service>/secret-id)
# 3. Authenticate to Vault
curl -X POST $VAULT_ADDR/v1/auth/approle/login \
-d "{\"role_id\":\"$role_id\",\"secret_id\":\"$secret_id\"}"
# 4. Receive service token (1h TTL)
# 5. Fetch service credentials using token
# 6. Start service with fetched credentials
See Vault Integration Guide for complete details.
| Service | Purpose | Access |
|---|---|---|
| HashiCorp Vault | Secrets management + PKI | localhost:8200 |
| PostgreSQL 18 | Primary relational database | localhost:5432 |
| PgBouncer | PostgreSQL connection pooling | localhost:6432 |
| MySQL 8.0.46 | Legacy application support | localhost:3306 |
| MongoDB 8.0 | NoSQL document database | localhost:27017 |
| Redis Cluster | 3-node distributed cache | localhost:6379-6381 (non-TLS), 6390-6392 (TLS) |
| RabbitMQ | Message queue + UI | localhost:5672, 15672 |
| Forgejo | Self-hosted Git server | localhost:3000 |
| Service | Purpose | Access |
|---|---|---|
| Prometheus | Metrics collection | localhost:9090 |
| Grafana | Metrics visualization | localhost:3001 |
| Loki | Log aggregation | localhost:3100 |
| Vector | Unified observability pipeline | - |
| cAdvisor | Container monitoring | localhost:8080 |
Production-quality API implementations in multiple languages:
| Language | Framework | Ports | Status |
|---|---|---|---|
| Python | FastAPI (Code-First) | 8000, 8443 | ✅ Complete |
| Python | FastAPI (API-First) | 8001, 8444 | ✅ Complete |
| Go | Gin | 8002, 8445 | ✅ Complete |
| Node.js | Express | 8003, 8446 | ✅ Complete |
| Rust | Actix-web | 8004, 8447 | ⚠️ Partial (~40%) |
All reference apps demonstrate:
See Reference Apps Overview for details.
The manage-devstack script provides all essential operations:
# Service management
./devstack start [--profile PROFILE] # Start services
./devstack stop # Stop services
./devstack restart # Restart services
./devstack status # Show status
./devstack health # Health checks
# Logs and debugging
./devstack logs [SERVICE] # View logs
./devstack shell SERVICE # Open shell in container
# Vault operations
./devstack vault-init # Initialize Vault
./devstack vault-bootstrap # Setup PKI + credentials
./devstack vault-status # Check Vault status
./devstack vault-show-password SERVICE # Get service password
# Redis cluster
./devstack redis-cluster-init # Initialize cluster
# Profiles
./devstack profiles # List available profiles
# Help
./devstack --help # Show all commands
./devstack COMMAND --help # Command-specific help
Daily Development:
# Morning: Start development environment
./devstack start --profile standard
# Check everything is healthy
./devstack health
# View logs if needed
./devstack logs postgres
# Evening: Stop everything (or leave running)
./devstack stop
Database Operations:
# Get database password
./devstack vault-show-password postgres
# Connect to PostgreSQL
psql -h localhost -p 5432 -U devuser -d devdb
# Connect to MySQL
mysql -h 127.0.0.1 -P 3306 -u devuser -p
# Connect to MongoDB
mongosh "mongodb://localhost:27017" --username devuser
Troubleshooting:
# Check service health
./devstack health
# View service logs
./devstack logs vault
./devstack logs redis-1
# Restart specific service
docker compose restart postgres
# Open shell for debugging
./devstack shell postgres
DevStack Core runs entirely on your local Mac with no cloud provider services required. This architectural decision provides significant benefits for development workflows.
✅ No Cloud Services Required:
✅ Complete Local Execution:
🔒 Data Sovereignty:
💰 Zero Cloud Costs:
✈️ Offline Development:
⚡ Low Latency:
🎮 Full Environment Control:
./devstack reset)DevStack Core does require local tools for container orchestration and package management:
Required Software:
Installation (one-time):
brew install colima docker docker-compose uv
Why These Tools?
When Local Development Excels:
When Cloud Makes Sense:
DevStack Core is optimized for local development while maintaining patterns that translate well to cloud deployments when needed.
docs/.private/ is gitignored)We welcome contributions! Here's how to get started:
git clone https://github.com/YOUR_USERNAME/devstack-core.gitgit checkout -b feature/amazing-featuregit commit -m 'feat: add amazing feature'git push origin feature/amazing-featureSee CONTRIBUTING.md for detailed guidelines.
Found a bug? Open an issue with:
Need help?
This project is licensed under the MIT License - see the LICENSE file for details.
You are free to:
Built with excellent open-source software:
See complete list: ACKNOWLEDGEMENTS.md
Made with ❤️ for the developer community
For questions or feedback, visit our GitHub repository.
NormB/devstack-core is a public repo on GitHub by NormB. Comprehensive local development infrastructure for VoIP services on Apple Silicon (M Series Processors) using Colima.
It declares the MIT license on GitHub.
Its maker tagged it for macOS, Windows and Linux, or as Docker or cross-platform. That is declared by the maker; Take My Repo has not tested it.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-19. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
A collection of inspiring lists, manuals, cheatsheets, blogs, hacks, one-liners, cli/web tools and more.
FastAPI framework, high performance, easy to learn, fast to code, ready for production
Full-stack observability · Metrics · Logs · Traces · Flows · Topology · Infrastructure · APM · NPM · DBM · RUM · Synthetics · Cloud · AI SRE · OpenTelemetry · SNMP · NetFlow/IPFIX/sFlow · IPMI · Redfish · 2000+ integrations

A list of Free Software network services and web applications which can be hosted on your own servers
Parsing gigabytes of JSON per second : used by Facebook/Meta Velox, the Node.js runtime, ClickHouse, WatermelonDB, Apache Doris, Milvus, StarRocks
SIP & RTP capture, analysis, and security tool. One binary, one dependency (libpcap), built in Rust.
Production-ready VoIP infrastructure with OpenSIPS, Asterisk, and RTPEngine for Apple Silicon
Language Server Protocol implementation for the Kamailio configuration file language (kamailio.cfg)
Language Server Protocol implementation for the OpenSIPS routing script language (opensips.cfg)

This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/NormB/devstack-coreTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.