Skip to content

WSL2 / Windows AppImage setup improvements for Basecamp #261

@kb-dev28

Description

@kb-dev28

Problem

Running Logos Basecamp on Windows via WSL2 requires additional setup that is not documented clearly for new users.

Context

I successfully ran Basecamp on Windows using WSL2 + AppImage. However, I encountered several issues:

  • Missing system libraries (libfuse2, Qt6 dependencies)
  • Graphics rendering issues in WSLg
  • AppImage execution required software rendering workaround

Suggested Improvement

Add a dedicated "Windows / WSL2 setup guide" including:

  • Required dependencies (libfuse2, libxcb, etc.)
  • Recommended environment variables (LIBGL_ALWAYS_SOFTWARE=1)
  • Known limitations for WSLg users
  • Troubleshooting section for Qt rendering issues

Why this matters

Many Windows developers will likely encounter these issues when onboarding to Basecamp and Logos development.

Optional Improvement

A prebuilt Windows installer or WSL-specific setup script would significantly improve onboarding.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions