Skip to content

feat: [#275] Change Grafana default port from 3100 to 3000#276

Merged
josecelano merged 1 commit into
mainfrom
275-change-grafana-default-port-to-3000
Jan 20, 2026
Merged

feat: [#275] Change Grafana default port from 3100 to 3000#276
josecelano merged 1 commit into
mainfrom
275-change-grafana-default-port-to-3000

Conversation

@josecelano
Copy link
Copy Markdown
Member

Summary

Changes the Grafana default port from 3100 to 3000, aligning with the industry standard.

Changes

  • Template: Updated docker-compose.yml.tera to expose Grafana on port 3000
  • Source code: Updated DEFAULT_GRAFANA_PORT constant and all test assertions
  • Documentation: Updated all active docs referencing port 3100
  • ADR: Added grafana-default-port-3000.md documenting the decision

Files Modified

Template

  • templates/docker-compose/docker-compose.yml.tera - Port mapping 3100:30003000:3000

Rust Source

  • src/infrastructure/remote_actions/validators/grafana.rs - Constant and docs
  • src/application/command_handlers/show/info/grafana.rs - URL generation and tests
  • src/presentation/views/commands/show/environment_info/grafana.rs - Test fixtures
  • src/testing/e2e/tasks/run_run_validation.rs - Error messages

Documentation

  • 10 documentation files updated (user guides, security docs, ADRs, e2e testing)
  • New ADR created: docs/decisions/grafana-default-port-3000.md

Rationale

Port 3000 is the industry standard for Grafana. The original use of port 3100 was a workaround for macOS port conflicts, but:

  1. Port 3000 never actually conflicted with macOS services
  2. Users expect Grafana on port 3000
  3. Most documentation and tutorials use port 3000

Testing

  • ✅ All 1848 unit tests pass
  • ✅ All 15 integration tests pass
  • ✅ Clippy lint check passes
  • ✅ Rustfmt check passes
  • ✅ Markdown lint passes

Fixes #275

- Update docker-compose template to expose Grafana on port 3000
- Update Rust source code constants and test assertions
- Update all active documentation referencing port 3100
- Add ADR documenting the port change decision

The previous port 3100 was a workaround for Docker on macOS, where
AirPlay uses port 5000 and AirTunes uses port 7000. However, port 3000
is the industry standard for Grafana and was never actually conflicting.

Fixes #275
@josecelano josecelano self-assigned this Jan 20, 2026
@josecelano
Copy link
Copy Markdown
Member Author

ACK c038170

@josecelano josecelano merged commit 3f6b4e4 into main Jan 20, 2026
48 checks passed
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.

Change Grafana default port from 3100 to 3000

1 participant