Docker
Appsmith can be deployed locally or on your private instance using Docker
Docker is an open-source containerization platform. It enables developers to package applications into containers—standardized executable components combining application source code with the operating system (OS) libraries and dependencies required to run that code in any environment.
Prerequisites
Create an installation folder called
appsmith where you would like your Appsmith installation and data storage.cd into the installation folder.Quick Start (with docker-compose)
The Appsmith Docker image is built with all the components required to run within a single Docker container. All these multiple processes are managed by a Supervisord instance, which is a lightweight process manager.
You can expect one container running when using the
docker-compose ps command. Something like:#Container appsmith Running
Docker-compose configuration
Currently, auto-update is disabled on the docker-compose file. If you want to enable auto-update for Appsmith, please uncomment all the commented lines in the docker-compose file.
Download the below
docker-compose.yml file into the appsmith installation folderdocker-compose.yml
625B
Code
or run the following curl if you're on a remote machine:
1
curl -L https://bit.ly/32jBNin -o $PWD/docker-compose.yml
Copied!
This configuration runs an Appsmith instance and a Watchtower instance to keep Appsmith automatically up-to-date.
Bring the docker container up by running the following command. (You may need to run as
sudo if docker and docker-compose are not accessible by your user)1
docker-compose up -d
Copied!
If it is not available locally, the command above will download the Docker images and start the services. You can follow the logs with the following command:
1
docker logs -f appsmith
Copied!
You should see a message
Appsmith is Running! once the container is ready. If this is your first time using docker, you should expect a welcome page similar to the one below..png?alt=media)
Welcome Page
Congratulations! Your Appsmith server should be up and running now. You can access it at http://localhost.
Updating Appsmith (with docker-compose)
To update Appsmith (configured with docker-compose) manually, go to the root directory of your setup and run the following command:
1
docker-compose pull && docker-compose rm -fsv appsmith && docker-compose up -d
Copied!
Enabling Appsmith Auto-updates (with docker-compose)
If your Appsmith setup does not have auto-update enabled (i.e. it will not have Watchtower container running along with Appsmith in the host machine) You can enable auto-update by followin the following steps:
- 1.Go the root directory of your Appsmith setup and run:
1
docker-compose down
Copied!
- 1.Open the
docker-compose.ymlfile with any text editor and uncomment all the lines that are commented out (line 13-23). - 2.Run the command:
1
docker-compose up -d
Copied!
Explore Appsmith (without docker-compose)
To quickly get Appsmith up and running, run the following command on your machine:
1
docker run -d --name appsmith -p 80:80 -v "$PWD/stacks:/appsmith-stacks" --pull always appsmith/appsmith-ce
Copied!
This command will download the image and start Appsmith. Once the download is complete, the server should be up in under a minute. You can follow the logs with the following command:
1
docker logs -f appsmith
Copied!
You should see the message
Appsmith is Running! once the container is readyRestarting Containers
If your containers are failing to restart, you can execute the below script to bring them up:
restart-container.sh
1KB
Binary
restart-containers.sh
copy the script to your installation folder and make it executable
1
chmod +x restart-containers.sh
2
./restart-containers.sh
Copied!
Updating Appsmith (without docker-compose)
To update Appsmith manually, go to the root directory of your setup and run the following commands:
1
docker rmi appsmith/appsmith-ce -f
2
docker pull appsmith/appsmith-ce
3
docker rm -f appsmith
4
docker run -d --name appsmith -p 80:80 -v "$PWD/stacks:/appsmith-stacks" appsmith/appsmith-ce
Copied!
Troubleshooting
If you encounter any errors during this process, check out our guide on debugging deployment errors. If you are still facing any issues, please reach out to [email protected] or join our Discord Server to speak to the Appsmith team directly!
Further Reading
Last modified 5d ago
Copy link
Edit on GitHub
Contents
Prerequisites
Quick Start (with docker-compose)
Docker-compose configuration
Updating Appsmith (with docker-compose)
Enabling Appsmith Auto-updates (with docker-compose)
Explore Appsmith (without docker-compose)
Restarting Containers
Updating Appsmith (without docker-compose)
Troubleshooting
Further Reading