appsmithorg / appsmithorg/appsmith-docs

[Docs]: Improvements for new contributors - Client/Server Setup - Users with Windows/WSL/Intellij

未关闭
#1,227 6 条评论 0 个 reaction 已指派 1 人 已指派给 @somangshu 在 GitHub 查看
主要语言
MDX
星标
97
派生
280
平均合并
4 小时 32 分钟
30 天内合并 PR
8

描述

### Is there an existing issue for this?

- [X] I have searched the existing issues

### Documentation Link

https://github.com/appsmithorg/appsmith/blob/release/contributions/ServerSetup.md, https://github.com/appsmithorg/appsmith/blob/release/contributions/ClientSetup.md

### Discord/slack/intercom Link

_No response_

### Describe the problem and improvement.

Having just recently set up a local dev environment, I ran into some issues (Windows 10, WSL, Intellij). In order to solve them I had to either google around or search the discord for previous answers. Having solved these, I'd like to add them to the documentation so that it can help any future fresh contributors.

I want to make changes to the following docs:
- https://github.com/appsmithorg/appsmith/blob/release/contributions/ServerSetup.md
- https://github.com/appsmithorg/appsmith/blob/release/contributions/ClientSetup.md

Mainly, it's these points here. I'll clean them up and fit them in the existing docs:

- Add some verbiage to more easily direct those using windows/wsl to the appropriate sections
- Run Config > Tick "do not build"
This is enabled by default. You're already building it with the build command, don't do it again. It will probably error out anyways.
- Run Config > Env Vars > Untick "include system environment variables"
If you're on windows using WSL, this will include the windows paths which will immediately error out.
- If the "environment variables" box isn't available, enable it with Run Config > Modify Options > Operating System > Environment Variables.
- Then, click the box to open the environment variables box, and uncheck "include system environment variables"
- Everything is running (client, server, mongo, redis, nginx) but I'm getting either "refused connection" OR site resolves with 503 application error
nginx is already running, but you may need to restart it:
`sudo systemctl stop nginx`
`sudo ./start-https.sh` (NOT systemctl start nginx)
- Refused to connect - Make sure you visit "http://dev.appsmith.com/" and not "http://dev.appsmith.com:3000/" even though that's what the server output tells you to use.

If you assign me this issue, I can get these added in.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。