Improve server setup experience documentation (#4441)

* fix: Updates appsmith server docker-compose

* fix: Updates server docker-compose

* fix: Removes exposed ports

* docs: Adds updates for server docker-compose

* docs: Adds updates for server docker-compose

* docs: Updates app/server/README.md

Co-authored-by: Arpit Mohan <mohanarpit@users.noreply.github.com>

* chore: Removes deprecated env vars

Co-authored-by: Arpit Mohan <mohanarpit@users.noreply.github.com>
This commit is contained in:
Confidence Okoghenun 2021-05-19 06:59:08 -07:00 committed by GitHub
parent 81f3ccd163
commit 639cba9095
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 58 additions and 30 deletions

View File

@ -11,5 +11,6 @@ node_modules
**/.classpath
**/.project
**/.factorypath
container-volumes
*.env
dependency-reduced-pom.xml

View File

@ -1,7 +1,39 @@
# Appsmith Server
This is the server-side repository for the Appsmith framework.
For details on setting up your development machine, please refer to the [Setup Guide](https://github.com/appsmithorg/appsmith/blob/release/contributions/ServerSetup.md)
For details on setting up your development machine, please refer to the [Setup Guide](../../contributions/ServerSetup.md). Alternatively, you can run the server using docker(see the instructions below).
## Dev Setup
For details on setting up the server on your development machine, please refer to the [Setup Guide](https://github.com/appsmithorg/appsmith/blob/master/contributions/ServerSetup.md)
## Run locally with Docker
You can run the server codebase in a docker container. This is the easiest way to get the server up and running if all you care about is contributing to the client codebase.
### What's in the box
* Appsmith server
* MongoDB
* Redis
### Pre-requisites
* [Docker](https://docs.docker.com/get-docker/)
### Steps for setup
1. Clone the Appsmith repository and `cd` into it
```sh
git clone https://github.com/appsmithorg/appsmith.git
cd appsmith
```
2. Change your directory to `app/server`
```sh
cd app/server
```
3. Create a copy of the `envs/docker.env.example`
```sh
cp envs/docker.env.example envs/docker.env
```
4. Start up the containers
```sh
docker-compose up -d
```
5. Have fun!

View File

@ -2,35 +2,30 @@ version: "3.7"
services:
appsmith-internal-server:
image: arpitappsmith/appsmith-server:maven
image: appsmith/appsmith-server
env_file: envs/docker.env
environment:
APPSMITH_MONGODB_URI: "mongodb://mongo:27017/mobtools"
APPSMITH_REDIS_URL: "redis://redis:6379"
APPSMITH_MONGODB_URI: "mongodb://mongo:27017/appsmith"
ports:
- "8080:8080"
links:
- mongo
depends_on:
- mongo
- redis
networks:
- appsmith
mongo:
image: mongo
ports:
- "27017:27017"
environment:
- MONGO_INITDB_DATABASE=mobtools
- MONGO_INITDB_DATABASE=appsmith
volumes:
- ./mongo-seed/:/docker-entrypoint-initdb.d/
- ./container-volumes/mongo:/data/db
networks:
- appsmith
redis:
image: redis
ports:
- "6379:6379"
networks:
- appsmith

View File

@ -1,25 +1,23 @@
#!/bin/sh
APPSMITH_OAUTH2_GOOGLE_CLIENT_ID=""
APPSMITH_OAUTH2_GOOGLE_CLIENT_SECRET=""
APPSMITH_OAUTH2_GITHUB_CLIENT_ID=""
APPSMITH_OAUTH2_GITHUB_CLIENT_SECRET=""
# APPSMITH_OAUTH2_GOOGLE_CLIENT_ID=""
# APPSMITH_OAUTH2_GOOGLE_CLIENT_SECRET=""
# APPSMITH_OAUTH2_GITHUB_CLIENT_ID=""
# APPSMITH_OAUTH2_GITHUB_CLIENT_SECRET=""
APPSMITH_RAPID_API_KEY_VALUE=""
# APPSMITH_MAIL_ENABLED=true
# APPSMITH_MAIL_HOST=localhost
# APPSMITH_MAIL_PORT=25
# APPSMITH_MAIL_USERNAME=
# APPSMITH_MAIL_PASSWORD=
# APPSMITH_MAIL_SMTP_AUTH=true
# APPSMITH_MAIL_SMTP_TLS_ENABLED=true
APPSMITH_MAIL_ENABLED=true
APPSMITH_MAIL_HOST=localhost
APPSMITH_MAIL_PORT=25
APPSMITH_MAIL_USERNAME=
APPSMITH_MAIL_PASSWORD=
APPSMITH_MAIL_SMTP_AUTH=true
APPSMITH_MAIL_SMTP_TLS_ENABLED=true
# APPSMITH_MARKETPLACE_USERNAME=""
# APPSMITH_MARKETPLACE_PASSWORD=""
APPSMITH_MARKETPLACE_USERNAME=""
APPSMITH_MARKETPLACE_PASSWORD=""
APPSMITH_ENCRYPTION_PASSWORD=""
APPSMITH_ENCRYPTION_SALT=""
APPSMITH_ENCRYPTION_PASSWORD="abcd"
APPSMITH_ENCRYPTION_SALT="abcd"
#APPSMITH_RECAPTCHA_SITE_KEY=""
#APPSMITH_RECAPTCHA_SECRET_KEY=""

View File

@ -2,6 +2,8 @@
The server codebase is written in Java and is powered by Spring + WebFlux. This document explains how you can setup a development environment to make changes and test your changes.
>For details on setting up with `Docker`, please refer to the [Setup Guide](../app/server/README.md#run-locally-with-docker)
## Pre-requisites
- Java --- OpenJDK 11.