SOLFIND
Web Lens
Portal home

Docker | Appsmith

https://docs.appsmith.com/getting-started/setup/installation-guides/docker • 54 KB fetched
Open original page


Docker | Appsmith

Skip to main content

Ask AI
Search

Ask Appsmith AI Submit message

Examples How do I install Appsmith using Docker? How do I connect to my local PostgreSQL database? How do I pass inputs from a widget to a query? How do I trigger multiple queries conditionally? How do I fix the error: This value does not evaluate to type Array<Object>?

Search

Try Appsmith

* Get Started

* Introduction

* Build Your First App

* Self Hosting

* New Installation Guides

* Docker

* Kubernetes (k8s)

* AWS AMI

* AWS ECS on EC2

* AWS ECS on Fargate

* Azure Container Instance

* Google Cloud Run

* DigitalOcean

* Ansible

* Airgapped Edition

* Manage Installation

* Upgrade Installation Guides

* Concepts

* Connect Data

* Overview

* How-to Guides

* Reference

* Datasources

* Query Settings

* Concepts

* Build Apps

* Overview

* Quickstart

* How-to Guides

* Reference

* Widgets

* Accessibility

* Theme

* Sample Apps

* Write Code

* Overview

* How-to Guides

* Reference

* Global Objects

* Global Functions

* JS Libraries

* Fetch API

* Data Transformation

* JavaScript Settings

* Concepts

* Best Practices

* Manage Apps and Users

* Authentication

* Granular Access Control

* Versioning with Git

* Setup SCIM Provisioning

* Embed Appsmith

* Migrate Applications

* Audit Logs

* Branding

* External Client Portal

* Packages

* Overview

* Tutorial

* How-to Guides

* Reference

* Package Version Control

* GIT Apps with Packages Best Practices

* Code Packages

* UI Packages

* Workflows

* Overview

* Tutorial

* How-to Guides

* Reference

* Workflow Triggers

* Workflow Queries

* Workflow Functions

* Pass Parameters to Workflows

* Run History

* Troubleshooting

* Overview

* Self-hosting Errors

* Application Errors

* Product

* FAQ

* Security

* Telemetry

* Support at Appsmith

* Privacy Policy

* Release Notes

* Contribute

© 2026 Appsmith, Inc.

*

* Self Hosting

* New Installation Guides

* Docker
On this page
Docker

This page provides instructions to install Appsmith using Docker.

How to install Appsmith using Docker Compose

Prerequisites ​

Before you begin, ensure you have the following prerequisites:

* Docker (version 20.10.7 or later)

* Docker-Compose (version 1.29.2 or later)

* Whitelist cs.appsmith.com in your firewall or security group’s outbound rules to ensure Docker can pull required images and dependencies. To verify connectivity after install, see Verify connectivity to cs.appsmith.com .

* Host memory : The default Docker Compose setup runs MongoDB, Redis, and PostgreSQL inside the Appsmith container. Plan for at least 8 GB of RAM on the host for this all-in-one deployment. If you externalize supporting services, the Appsmith container may need less host memory. See Infrastructure and capacity planning .

Install Appsmith ​

Follow these steps to install Appsmith:

*
Create a folder named appsmith on your machine for deployment and data storage. Navigate to this folder using the cd command.

*
Create a docker-compose.yml file with:

version : "3"
services :
appsmith :
image : index.docker.io/appsmith/appsmith - ee : <version >
container_name : appsmith
ports :
- "80:80"
- "443:443"
volumes :
- ./stacks : /appsmith - stacks
restart : unless - stopped

Pin the image to a release tag
Replace <version> with a release tag from Appsmith on GitHub (for example, v1.98 ). Pinning the image avoids unexpected upgrades when you recreate the container and is recommended for production. If you omit the tag, Docker uses latest , which is acceptable for quick local trials but gives you less control over upgrades.

The appsmith-ee image installs the Commercial edition (recommended), which offers a free plan and the flexibility to upgrade to a paid plan at any point. To install the Community edition , replace appsmith-ee with appsmith-ce in the image name and keep the same :<version> suffix in the image attribute within the docker-compose.yml file.

*
Start the Docker container by using the below command. You may need to use sudo if you don't have permission to run docker-compose :

docker-compose up -d

This command will download the necessary Docker image if it doesn't exist locally and start the container.

*
Open http://localhost and wait for the server to come up. This can take up to 5 minutes. Once the server is up and running, you can access Appsmith at http://localhost .

*
Fill in your details to create an administrator account.

*
Once you've created an account, you can either start with the free plan or activate your instance with a license key. If you want to generate a license key, sign up on customer.appsmith.com to create one, and then proceed to activate your instance using the newly generated license key.

Post-installation configuration ​

Once you have completed the installation process, consider performing the tasks below to configure and manage your Appsmith instance, enhancing its security and performance, specifically if it's intended for production use.

Configure Single Sign-on (SSO)

Configure SSO to allow users to sign in using your identity provider. Learn more about configuring SSO.

Configure Email Service

Set up an email service to enable Appsmith to send notifications and alerts. Learn more about configuring email services.

Set Up Custom Domain and SSL

Set up a custom domain for your Appsmith instance and secure it with SSL. Learn more about setting up custom domains and SSL.

Backup and Restore

Ensure the safety of your Appsmith instance data by regularly backing up and restoring it when needed. Learn more about Backup and Restore.

Troubleshooting ​

If you are facing issues during deployment, refer to the guide on troubleshooting deployment errors . If you continue to face issues, contact the support team using the chat widget at the bottom right of this page.

See also ​

* Manage Installation : Learn how to manage your Appsmith instance.

* Upgrade Installation Guides : Learn how to upgrade your Appsmith installation.

Was this page helpful?

Edit this page

Previous
New Installation Guides
Next
Kubernetes (k8s)

* Prerequisites

* Install Appsmith

* Post-installation configuration

* Troubleshooting

* See also

Links found on this page

  1. Skip to main content [direct]
  2. Try Appsmith [direct]
  3. Get Started [direct]
  4. Build Your First App [direct]
  5. Self Hosting [direct]
  6. New Installation Guides [direct]
  7. Kubernetes (k8s) [direct]
  8. AWS AMI [direct]
  9. AWS ECS on EC2 [direct]
  10. AWS ECS on Fargate [direct]
  11. Azure Container Instance [direct]
  12. Google Cloud Run [direct]
  13. DigitalOcean [direct]
  14. Ansible [direct]
  15. Airgapped Edition [direct]
  16. Manage Installation [direct]
  17. Upgrade Installation Guides [direct]
  18. Concepts [direct]
  19. Connect Data [direct]
  20. How-to Guides [direct]
  21. Reference [direct]
  22. Query Settings [direct]
  23. Concepts [direct]
  24. Build Apps [direct]
  25. Quickstart [direct]
  26. How-to Guides [direct]
  27. Reference [direct]
  28. Widgets [direct]
  29. Accessibility [direct]
  30. Theme [direct]
  31. Sample Apps [direct]
  32. Write Code [direct]
  33. How-to Guides [direct]
  34. Reference [direct]
  35. Global Objects [direct]
  36. Global Functions [direct]
  37. JS Libraries [direct]
  38. Fetch API [direct]
  39. Data Transformation [direct]
  40. JavaScript Settings [direct]
  41. Concepts [direct]
  42. Best Practices [direct]
  43. Manage Apps and Users [direct]
  44. Granular Access Control [direct]
  45. Versioning with Git [direct]
  46. Setup SCIM Provisioning [direct]
  47. Embed Appsmith [direct]
  48. Migrate Applications [direct]
  49. Audit Logs [direct]
  50. Branding [direct]
  51. External Client Portal [direct]
  52. Packages [direct]
  53. Tutorial [direct]
  54. How-to Guides [direct]
  55. Reference [direct]
  56. GIT Apps with Packages Best Practices [direct]
  57. Code Packages [direct]
  58. UI Packages [direct]
  59. Workflows [direct]
  60. Tutorial [direct]
  61. How-to Guides [direct]
  62. Reference [direct]
  63. Workflow Queries [direct]
  64. Workflow Functions [direct]
  65. Pass Parameters to Workflows [direct]
  66. Run History [direct]
  67. Troubleshooting [direct]
  68. Self-hosting Errors [direct]
  69. Application Errors [direct]
  70. Product [direct]
  71. Security [direct]
  72. Telemetry [direct]
  73. Support at Appsmith [direct]
  74. Privacy Policy [direct]
  75. Release Notes [direct]
  76. Contribute [direct]
  77. Docker [direct]
  78. Docker-Compose [direct]
  79. Verify connectivity to cs.appsmith.com [direct]
  80. Infrastructure and capacity planning [direct]