v1.3
Core Concepts
Datasource Reference
Framework Reference
Widget Reference
Docker
Appsmith can be deployed locally or on your private instance using Docker
Prerequisites
Create an installation folder called
appsmithwhere 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.
Docker-compose configuration
Download the below
docker-compose.yml file into the appsmith installation folderdocker-compose.yml
571B
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!
This command will download the Docker images, if not already locally available, 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 readyCongratulations! Your Appsmith server should be up and running now. You can access it at http://localhost.
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 -p 9001:9001 -v "$PWD/stacks:/appsmith-stacks" appsmith/appsmith-ce
Copied!
This 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 a 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!
Troubleshooting
If you encounter any errors during this process, check out our guide on debugging deployment errors. If you are still facing any issue, please reach out to [email protected] or join our Discord Server to speak to the Appsmith team directly!
Further Reading
Last modified 1mo ago