Skip to content

Verify the public self-hosting guide through connection and first collection #44

Open

Description

@xiaoland

The public self-hosting manual needs a verified path from deployment through connection to the first collection. impl-ts#120 contains deployment screenshots, but does not identify their versions, steps, or current applicability.

Documentation contributions are welcome. Coordination contact: @xiaoland. Comment before taking this task and name the deployment method you intend to check.

Start with website/content/en/self-hosted/index.md, one concrete deployment guide, website/content/en/guide/connect.md, and website/content/en/guide/first-source.md. The published entry is Self-hosted.

Check the existing public instructions and released artifacts, record successful steps or precise blockers, and correct guide problems supported by those observations. Verify screenshots against the actual versions before reusing them. Remove real JWT secrets, connection files, and personal information from any new images.

No organization package token or impl-ts source build is required. If a supposedly public artifact cannot be obtained anonymously, record its URL, version, and a redacted response as a blocker rather than requesting organization credentials.

Acceptance:

  • Record the guide, client/peer/extension versions, deployment method, and observation date.
  • Describe the actual outcome of deployment, connection, and first collection. For a blocked step, provide the shortest reproduction and the condition needed to continue.
  • Link documentation changes to the observations that justify them. Screenshots must match the steps and contain no secrets.
  • For website changes, run pnpm --dir website check and identify any acceptance work still requiring a maintainer.

This is a help wanted task involving deployment judgment, not yet a good first issue. Leave the implementation assignee empty until someone takes it; @xiaoland coordinates scope and questions.

Activity

  1. added
    documentationImprovements or additions to documentation
    help wantedDefined scope and acceptance; external contributions welcome; a coordination contact is named.
    on Oct 26, 2026
  2. changed the title [-]复核公开自部署指南并补齐首次连接与采集步骤[/-] [+]Verify the public self-hosting guide through connection and first collection[/+] on Oct 26, 2026
  3. moved this to Ready to pick up in InKCre Current Workon Oct 26, 2026
  4. added theissue type on Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationhelp wantedDefined scope and acceptance; external contributions welcome; a coordination contact is named.

    Type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions