Skip to content

docs: add Docker usage verification and troubleshooting to README#2532

Open
okwn wants to merge 1 commit into
lightpanda-io:mainfrom
okwn:contrib/lightpanda/docker-usage-docs
Open

docs: add Docker usage verification and troubleshooting to README#2532
okwn wants to merge 1 commit into
lightpanda-io:mainfrom
okwn:contrib/lightpanda/docker-usage-docs

Conversation

@okwn
Copy link
Copy Markdown

@okwn okwn commented May 23, 2026

Summary

  • Added Docker usage verification steps and troubleshooting to README
  • Shows how to verify container is running and check logs
  • Added common Docker issues and their solutions

Problem

New users sometimes hit Docker issues (port conflicts, permission errors, container exits) with no troubleshooting guidance in the README.

Solution

Added after the docker run command:

  • Docker verification commands (docker ps, docker logs)
  • Common issues section with solutions:
    • Port already in use
    • Permission denied on Linux
    • Container exits immediately

Tests

Documentation only.

Risk / Compatibility

  • Docs only, no runtime changes

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.

1 participant