# Appsmith
Appsmith is a JS-based internal tool development platform. Internal tools take a lot of time to build even though they involve the same UI components, data integrations, and user access management. Developers love Appsmith because it saves them hundreds of hours.

Build interactive web apps by using UI components like a table, form components, button, charts, rich text editor, map, tabs, modal, and many more.

API Support: CURL importer for REST APIs Database Support: PostgreSQL, MongoDB, MySQL, Redshift, Elastic Search, DynamoDB, Redis, & MSFT SQL Server.
## TL;DR
---
```
helm repo add stable-appsmith http://helm.appsmith.com

helm repo update

helm install stable-appsmith/appsmith --generate-name
```

## Introduction
---
This chart bootstrap an [Appsmith](https://github.com/appsmithorg/appsmith) deployment on a [Kubernetes](kubernetes.io) cluster using [Helm](https://helm.sh) package manager.

## Prerequisites
---
* Install Helm package manager: [https://helm.sh/docs/intro/install/](https://helm.sh/docs/intro/install/)
* Ensure `kubectl` is installed and configured to connect to your cluster
    * Install kubectl: [kubernetes.io/vi/docs/tasks/tools/install-kubectl/](https://kubernetes.io/vi/docs/tasks/tools/install-kubectl/)
    * Minikube: [Setup Kubectl](https://minikube.sigs.k8s.io/docs/handbook/kubectl/)
    * Google Cloud Kubernetes: [Configuring cluster access for kubectl](https://cloud.google.com/kubernetes-engine/docs/how-to/cluster-access-for-kubectl)
    * Aws EKS: [Create a kubeconfig for Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html)

    * Microk8s: [Working with kubectl](https://microk8s.io/docs/working-with-kubectl)
* Ensure you have a default storage class running on your cluster. Please follow one of below guideline to enable your default storage class in case of no existing one
  * Minikube: [Enable addon default-storageclass](https://kubernetes.io/docs/tutorials/hello-minikube/#enable-addons)
  * Google Cloud Kubernetes: [Setting up default storage class on GKE](https://cloud.google.com/anthos/clusters/docs/on-prem/1.3/how-to/default-storage-class)
  * AWS EKS: [Create default storage class](https://docs.aws.amazon.com/eks/latest/userguide/storage-classes.html)
  * Microk8s: [Enable storage](https://microk8s.io/docs/command-reference#heading--microk8s-enable)
* Kubernetes NGINX Ingress Controller should be enable on your cluster by default. Please make sure that you install the right version for your cluster
    * Minikube: [Set up Ingress on Minikube with the NGINX Ingress Controller](https://kubernetes.io/docs/tasks/access-application-cluster/ingress-minikube/)
    * Google Cloud Kubernetes: [Ingress with NGINX controller on Google Kubernetes Engine](https://kubernetes.github.io/ingress-nginx/deploy/)
    * AWS EKS: [Install NGINX Controller for AWS EKS](https://kubernetes.github.io/ingress-nginx/deploy/#network-load-balancer-nlb)
    * Microk8s: [Add on: Ingress](https://microk8s.io/docs/addon-ingress)
## Installing the Chart
---
To install the chart with the release `appsmith`
```
helm install stable-appsmith/appsmith --generate-name
```
The command deploys Appsmith application on Kubernetes cluster in the default configuration. The [Parameters](https://github.com/appsmithorg/appsmith/tree/release/deploy/helm#paramters) section lists the parameters that can be configured during installation.
## Uninstalling the Chart
---
To uninstall the `appsmith` release:
```
helm list
NAME                       NAMESPACE       REVISION        UPDATED                                 STATUS          CHART           APP VERSION
appsmith-1631069261        default         1               2021-09-09 11:24:40.152766 +0700 +07    deployed        appsmith-1.3.0  1.16.0

helm uninstall appsmith-1631069261
```
The command uninstalls the release and removes all Kubernetes resources associated with the chart
## Parameters

### Global parameters

| Name 											 | Description 																								| Value 	|
| -------------------------- | ---------------------------------------------------------- | ------- |
| `global.namespaceOverride` | Override the namespace for resource deployed by the chart	| `""`	 	|
| `global.storageClass`			 | Global StorageClass for Persistent Volume(s)								| `""`  	|

### Common parameters
| Name 								| Description 																			| Value 				|
| ------------------- | ------------------------------------------------- | ------------- |
| `fullnameOverride`  | String to fully override `appsmith.name` template | `""`	 				|
| `containerName`			| Specify container's name running in the pods			| `"appsmith"` 	|
| `commonLabels`      | Labels to add to all deployed objects							| `{}` 					|
| `commonAnnotations`	| Annotations to add to all deployed objects 				| `{}` 					|

### Appsmith Image parameters
| Name 								| Description 								| Value 											|
| -------------------	| --------------------------- | --------------------------- |
| `image.registry`		| Appsmith image registry			| `index.docker.io` 					|
| `image.repository`	| Appsmith image repository		| `appsmith/appsmith-editor` 	|
| `image.tag`					| Appsmith image tag					| `latest` 										|
| `image.pullPolicy`	| Appsmith image pull policy	| `IfNotPresent` 							|

### Appsmith deployment parameters
| Name 											 	| Description 																				| Value 					|
| --------------------------- | --------------------------------------------------- | --------------- |
| `strategyType`							| Appsmith deployment strategy type										| `RollingUpdate` |
| `schedulerName`							| Alternate scheduler																	| `""`						|
| `podAnnotations`						| Annotations for Appsmith pods												| `{}`						|
| `podLabels`						| Labels for Appsmith pods												| `{}`						|
| `podSecurityContext`				| Appsmith pods security context											| `{}`						|
| `securityContext`						| Set security context																| `{}`						|
| `resources.limit`						| The resources limits for the Appsmith container			| `{}`						|
| `resources.requests`				| The requested resources for the Appsmith container	| `{}`						|
| `nodeSelector`							| Node labels for pod assignment											| `{}`						|
| `tolerations`								| Tolerations for pod assignment											| `[]`						|
| `affinity`									| Affinity fod pod assignment													| `{}`						|

### Appsmith service account parameters
| Name 											 		| Description 																																				 												| Value 	|
| ----------------------------- | ----------------------------------------------------------------------------------------------------------- | ------- |
| `serviceAccount.create`    		| Enable creation of `ServiceAccount` for Appsmith pods															 													| `true` 	|
| `serviceAccount.name`      		| Name of the created `ServiceAccount` . If not set, a name is generated using the appsmith.fullname template	| `""` 		|
| `serviceAccount.annotations` 	| Additional service account annotations																						 													| `{}` 		|

### Traffic Exposure Parameters
| Name 											 					| Description 																																				 		| Value 			|
| ----------------------------------- | --------------------------------------------------------------------------------------- | ----------- |
| `service.type` 						 					| Appsmith service type																															 			| `ClusterIP` |
| `service.port`						 					| Appsmith service port																															 			| `80` 				|
| `service.portName` 				 					| Appsmith service port name																													 		| `appsmith` 	|
| `service.nodePort` 				 					| Appsmith service node port to expose to expose                              				 		| `8000` 			|
| `service.clusterIP`        					| Appsmith service Cluster																														 		| `""` 				|
| `service.loadBalancerIP`   					| Appsmith service Load Balancer IP																									 			| `""` 				|
| `service.loadBalancerSourceRanges`	| Appsmith service Load Balancer sources                                      						| `[]` 				|
| `service.annotations` 		 					| Additional custom annotations for Appsmith service 																 			| `{}` 				|
| `ingress.enabled` 				 					| Enable ingress record generation for Appsmith                                       		| `false` 		|
|	`ingress.annotations`								|	Additional custom annotations for Ingress																								|	`{}`				|
| `ingress.hosts`            					| An array of hosts to be covered with the ingress record                             		| `[]` 				|
| `ingress.tls`              					| Enable TLS configuration for the hosts defined at `ingress.hosts` parameter         		| `false` 		|
| `ingress.secrets`										| Custom TLS certificates as secrets																											| `[]`				|
| `ingress.certManager`								| Enable ingress to use TLS certificates provided by Cert Manager													| `false` 		|
| `ingress.certManagerTls`						| Specify TLS secret resources created by Cert Manager																		| `[]`				|
| `ingress.className`						      | Configure Ingress class that being used in ingress resource															| `""`				|

### Persistence parameters
| Name 											 					| Description 																													| Value 							|
| ----------------------------------- | --------------------------------------------------------------------- | ------------------- |
| `persistence.enabled`								| Enable persistence using Persistent Volume Claims											| `true`							|
| `persistence.storageClass`					| Persistent Volume storage class																				| `""`								|
| `persistence.annotations`					  | Additional custom annotations for the PVC															| `{}`								|
| `persistence.localStorage`					| Enable persistent volume using local storage													| `false`							|
| `persistence.storagePath`						| Local storage path																										| `/tmp/hostpath_pv`	|
| `persistence.localCluster`					| Local running cluster to provide storage space												| `[minikube]` 				|
| `persistence.accessModes`						| Persistent Volume access modes																				| `[ReadWriteOnce]`		|
| `persistence.size`									| Persistent Volume size																								|	`10Gi`							|
| `storageClass.enabled`							| Enable Storage Class configuration																		| `false`							|
| `storageClass.defaultClass`					| Create default Storage Class																					| `false`							|
| `storageClass.bindingMode`					| Binding mode for Persistent Volume Claims using Storage Class					| `Immediate`					|
| `storageClass.allowVolumeExpansion` | Allow expansion of Persistent Volume Claims using Storage Class				| `true`							|
| `storageClass.reclaimPolicy`				| Configure the retention of the dynamically created Persistent Volume	| `Delete`						|
| `storageClass.provisioner`					| Storage Class provisioner																							| `""`								|
| `storageClass.annotations`					| Additional storage class annotations																	| `{}`								|
| `storageClass.mountOptions`					| Mount options used by Persistent Volumes															| `{}`								|
| `storageClass.parameters`						| Storage Class parameters																							| `{}`								|

### Auto update chart's image
| Name										| Description																		|	Value					|
| -----------------------	|	--------------------------------------------- | -------------	|
| `autoupdate.enabled`		| Enable auto update Helm chart's image					| `true`				|
| `autoupdate.scheduler`	| Schedule time to run cron job to update image	| `"0 * * * *"`	|

Specify each parameter using `--set key=value[,key=value]` argument to helm install. For example:
```
helm install \
--set persistence.storageClass=appsmith-pv \
  stable-appsmith/appsmith --generate-name
```
The above command deploys Appsmith application and configure application to use storage class name `appsmith-pv`

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example:
```
helm install -f values.yaml stable-appsmith/appsmith --generate-name
```

*Tip: You can use the default [values.yaml](https://github.com/appsmithorg/appsmith/blob/release/deploy/helm/values.yaml)*

### Appsmith configuration
To change Appsmith configurations, you can use configuration UI in application or update value in values.yaml(The available configurations is listed below).
|	Name																										|	Value									|
|	----------------------------------------------------		|	---------------------	|
| `applicationConfig.APPSMITH_OAUTH2_GOOGLE_CLIENT_ID`		| `""`									|
| `applicationConfig.APPSMITH_OAUTH2_GOOGLE_CLIENT_SECRET`| `""`									|
| `applicationConfig.APPSMITH_OAUTH2_GITHUB_CLIENT_ID`		| `""`									|
| `applicationConfig.APPSMITH_OAUTH2_GITHUB_CLIENT_SECRET`| `""`									|
| `applicationConfig.APPSMITH_CLIENT_LOG_LEVEL`						| `""`									|
| `applicationConfig.APPSMITH_GOOGLE_MAPS_API_KEY`				| `""`									|
| `applicationConfig.APPSMITH_MAIL_ENABLED`								| `""`									|
| `applicationConfig.APPSMITH_MAIL_HOST`									| `""`									|
| `applicationConfig.APPSMITH_MAIL_PORT`									| `""`									|
| `applicationConfig.APPSMITH_MAIL_USERNAME`							| `""`									|
| `applicationConfig.APPSMITH_MAIL_PASSWORD`							| `""`									|
| `applicationConfig.APPSMITH_MAIL_FROM`									| `""`									|
| `applicationConfig.APPSMITH_REPLY_TO`										| `""`									|
| `applicationConfig.APPSMITH_MAIL_SMTP_AUTH`							| `""`									|
| `applicationConfig.APPSMITH_MAIL_SMTP_TLS_ENABLED`			| `""`									|
| `applicationConfig.APPSMITH_DISABLE_TELEMETRY`					| `""`									|
| `applicationConfig.APPSMITH_RECAPTCHA_SITE_KEY`					| `""`									|
| `applicationConfig.APPSMITH_RECAPTCHA_SECRET_KEY`				| `""`									|
| `applicationConfig.APPSMITH_RECAPTCHA_ENABLED`					| `""`									|
| `applicationConfig.APPSMITH_MONGODB_URI`								| `""`									|
| `applicationConfig.APPSMITH_REDIS_URL`									| `""`									|
| `applicationConfig.APPSMITH_ENCRYPTION_PASSWORD`				| `""`									|
| `applicationConfig.APPSMITH_ENCRYPTION_SALT`						| `""`									|
| `applicationConfig.APPSMITH_CUSTOM_DOMAIN`							| `""`									|
| `applicationConfig.APPSMITH_FORM_LOGIN_DISABLED`        | `""`                  |
| `applicationConfig.APPSMITH_SIGNUP_DISABLED`            | `""`                  |

For example, to change the encryption salt configuration, you can run the following command:
```
helm install \
--set applicationConfig.APPSMITH_ENCRYPTION_SALT=123 \
  stable-appsmith/appsmith --generate-name
```

## Expose Appsmith
- If you wish to publish your Appsmith to the world through the Internet, you will need to setup the Ingress controller firstly. Please refer to the section **Kubernetes NGINX Ingress Controller** in the [Prerequisites](https://github.com/appsmithorg/appsmith/tree/release/deploy/helm#prerequisites)
- In case of you have not install the Helm chart yet, you can run the below command to install it with exposing Appsmith
```
helm install stable-appsmith/appsmith --generate-name \
  --set ingress.enabled=true \
  --set ingress.annotations."kubernetes\.io/ingress\.class"=nginx \
  --set service.type=ClusterIP
```
- If you have installed Appsmith Helm chart, please run the `helm upgrade` command to upgrade the existing installation
```
helm upgrade stable-appsmith/appsmith appsmith \
  --set ingress.enabled=true \
  --set ingress.annotations."kubernetes\.io/ingress\.class"=nginx \
  --set service.type=ClusterIP

# Or this command if you are using values.yaml file
helm upgrade --values values.yaml stable-appsmith/appsmith appsmith
```
## Troubleshooting
If at any time you encounter an error during the installation process, reach out to support@appsmith.com or join our Discord Server

If you know the error and would like to reinstall Appsmith, simply delete the installation folder and the templates folder and execute the script again