docs: add manual WSL setup steps for SSL and port binding#56
Open
iArroe wants to merge 1 commit intoiloveitaly:masterfrom
Open
docs: add manual WSL setup steps for SSL and port binding#56iArroe wants to merge 1 commit intoiloveitaly:masterfrom
iArroe wants to merge 1 commit intoiloveitaly:masterfrom
Conversation
iloveitaly
requested changes
Feb 24, 2026
Owner
iloveitaly
left a comment
There was a problem hiding this comment.
- follow the PR template when submitting a PR
- way too much text in your description, make it shorter
| @@ -0,0 +1,13 @@ | |||
| # Updated WSL Ports for Today | |||
| export OPENAI_API_KEY="api-key" | ||
| export SENTRY_DSN="backend-dsn" | ||
| export POSTHOG_SECRET_KEY="secret-key" | ||
| # op_inject_source <<'EOF' |
Owner
There was a problem hiding this comment.
don't include all changes, just the changes for the WSL setup
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I’ve managed to get the full local environment up and running with a secure HTTPS trust chain. Since the automated scripts ran into some hurdles with how WSL interacts with the Windows host, I had to perform several manual interventions to bridge the gap. Here’s a quick rundown of what I did to get the project operational:
To start, I had to handle some foundational pathing issues by locating the localias binary within the version manager and manually linking it to /usr/local/bin. Once the command was accessible, I shifted focus to the networking and security side to ensure the frontend and backend could talk to each other securely. This involved a few key steps:
Identified the binary path in my version manager and established a global symbolic link and execution permissions so the localias command would work across the system.
Used setcap to grant the binary permission to bind to ports 80 and 443. This was necessary to allow the daemon to handle web traffic without needing to run every command as root.
Performed a recursive ownership fix on the .local/state/localias directory to ensure my user had full access to the PKI store and private keys, which resolved some early "permission denied" errors.
Manually extracted the Root CA from the Linux environment and imported it into the Windows Trusted Root Certification Authorities store. This is what finally cleared the "Not Secure" warnings and gave me the green padlock in Brave.
Initialized the Docker daemon within WSL to stand up our containerized dependencies. This ensured that Postgres, Redis, and Mailpit were properly provisioned and mapped to their respective project subdomains.
Audited the Windows host for port collisions and disabled the W3SVC service to make sure the WSL traffic controller could "own" the local domains without interference.
By clearing these hurdles, the full stack is now synchronized. The Vite frontend is live at https://web.localhost and the FastAPI backend documentation is fully accessible at https://api.python-template.localhost/docs.