Ansible

Deployment Steps:
​Install Ansible​
​Ansible inventory setup​
​Ansible configuration vars setup for Appsmith​
​Run the Ansible playbook​
Step 1: Install Ansible
You can skip this step if you already have ansible intalled.
There are two options for installing Ansible:
Option 1: Using OS specific Package Managers.
To install on Ubuntu, you can run the following commands:
1
$ sudo apt update
2
$ sudo apt install software-properties-common
3
$ sudo add-apt-repository --yes --update ppa:ansible/ansible
4
$ sudo apt install ansible
Copied!
Please refer to Ansible's official installation guide for other operating systems.
Option 2: Using pip:
1
$ sudo pip install ansible
Copied!
If you do not have pip installed on your system, please refer to Ansible's official guide on installing with pip.​
Step 2: Ansible inventory setup
1.Clone the Appsmith repository to your machine & move to the ansible playbook folder.
1
$ git clone https://github.com/appsmithorg/appsmith.git
2
$ cd ./appsmith/deploy/ansible/appsmith_playbook
Copied!
2.Create the inventory file.
1
    $ touch inventory
Copied!
3.To configure the inventory file, open it with your editor and add the the hostname or FQDN of the server(s) you want to deploy Appsmith, along with the ansible port and ansible_user.
The inventory file should follow the given format:
1
appsmith ansible_host={{ SERVER_HOST }} ansible_port={{ SERVER_PORT }} ansible_user={{ SERVER_USER }}
Copied!
If you are using SSH keypairs for authenticating your SSH connections to your server. You can specify your ssh private key file in the inventory file using ansible_ssh_private_key_file
1
appsmith ansible_host={{ SERVER_HOST }} ansible_port={{ SERVER_PORT }} ansible_user={{ SERVER_USER }} ansible_ssh_private_key_file={{ SSH_PRIVATE_KEY_FILE }}
Copied!
Step 3: Ansible configuration vars setup for Appsmith
1.Open appsmith-vars.yml file with your editor.
There are some variables that will need input from you to get the application start correctly
install_dir: The absolute path of your app's installation folder on the server (required). Default value: ~/appsmith
Step 4: Run the Ansible playbook
You can run the ansible playbook with the following command:
1
$ ansible-playbook -i inventory appsmith-playbook.yml --extra-vars "@appsmith-vars.yml"
Copied!
The command above will use the host information from the inventory file & feed your configuration vars from appsmith-vars.yml before running the playbook
When it's all done, provided all went well and no parameters were changed, you should be able to visit your app on browser using your custom_domain or by your SERVER_HOST (if you didn't provide value for custom_domain variable )
Note: You can put your inventory file in other folder and then specify its path with the -i flag, for more detail, please check Ansible Inventory documentation​
Troubleshooting
If you encounter any errors during this process, check out our guide on debugging deployment errors, if you are still facing an issue please reach out to [email protected] or join our Discord Server to directly speak to the appsmith team!

CloudJiffy

Instance Configuration

Last modified 1mo ago

Copy link

Edit on GitHub

Contents

Deployment Steps:

Step 1: Install Ansible

Step 2: Ansible inventory setup

Step 3: Ansible configuration vars setup for Appsmith

Step 4: Run the Ansible playbook

Troubleshooting