Skip to main content

AWS AMI

This page provides steps to install Appsmith using an Amazon Machine Image (AMI).

Prerequisites

  • Amazon Web Services (AWS) account. If you don't have one, Create an AWS Account.
  • An Amazon EC2 key pair. If you don't have one, Generate an SSH Key pair.
  • An Amazon Security group with ports 80, 443, and 22 accessible. If you don't have one, Create a Security Group.
  • To enable port access, add an inbound rule for the port ranges 80, 443, and 22 to the security group you created above.
  • Ensure you have created the security group and the SSH key pair in the same region.

Install Appsmith

Follow these steps to install Appsmith using an Amazon Machine Image (AMI):

  1. Go to the EC2 Dashboard.

  2. Scroll down to the Launch instance section.

  3. Click the Launch instance button, and select Launch instance.

  4. On the Launch instance screen, scroll down to the Application and OS images(Amazon Machine Image) section.

  5. Search for Appsmith in the search bar.

  6. In the search results, click AWS Marketplace AMIs.

  7. Select the image:

    • To install the Community Edition, click on the Select button available on the right side of the Appsmith Community Edition image.
    • To install the Business Edition, click on the Select button available on the right side of the Appsmith Business Edition image.
  8. On the Launch an instance screen:

    a. Configure the instance as below:

    AttributeValue
    NameGive a desired name.
    Instance typeA minimum t3.medium or t3a.medium is needed.
    Key pairSelect the Key pair you created in the Prerequisites section.

    b. Scroll down to the Networking section, and configure as below:

    AttributeValue
    Firewall (security groups)Select Select existing security group checkbox.
    Security groupsSelect the security group that you created in the Prerequisites section.
  9. Keep the default selection for other fields.

  10. Click the Launch Instance button. You see a launch status screen as shown below:

A launch status screen shows the server status.
A launch status screen shows the server status
  1. Follow these steps to verify the Appsmith installation:

    a. On the Launch status screen, click the EC2 instance id available in the bracket.

    b. Click the Instance ID to access the Instance Summary page.

    c. Copy the Public IPv4 address available on the Instance Summary page.

    Use DNS or Public IP to access Appsmith.
    Use DNS or Public IP to access Appsmith

    d. Paste it in a browser tab and wait for the server to come up. It can take up to 5 minutes.

    e. Once the server is up and running, you can see the login screen of Appsmith.

  2. Follow these steps to log into the instance using default root admin credentials:

    a. Username: appsmith@example.com

    b. Find the password in one of the below ways:

    • SSH into your server using your private key and find the application credentials with:

      sudo cat /home/ubuntu/appsmith/credential
    • Or review the system log, by selecting Get System Log from the Actions drop-down menu for your instance. The credentials are printed in the logs as shown below:

      Attention

      The application password is only available in system logs for the initial 24 hours. It's recommended that create a new admin user and delete the appsmith@example.com user immediately.

    Appsmith default credentials
    Appsmith default credentials
  3. If you are on a Business Edition:

    • Sign up on customer.appsmith.com and generate a trial license key.
    • Enter your license key to activate the instance.

Troubleshooting

Some common errors that you may face during installation:

If you continue to face issues, contact the support team using the chat widget at the bottom right of this page.

Further reading