Configure HTTP/HTTPS Proxy | Appsmith

https://docs.appsmith.com/getting-started/setup/instance-configuration/http-proxy • 50 KB fetched
Open original page
Configure HTTP/HTTPS Proxy | 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

* Manage Installation

* High Availability Guides

* Authentication Guides

* Helm Chart

* Custom Domain and SSL Guides

* Email Setup Guides

* Backup and Restore Guides

* Other Configuration Guides

* Configure External MongoDB

* Configure External PostgreSQL (AWS RDS)

* Configure External Redis

* In-Memory Git (Redis-backed)

* Configure PostgreSQL for SAML SSO (Azure)

* Configure HTTP/HTTPS Proxy

* Configure Environment Variables

* Get Container Logs

* Configure Google Maps

* Schedule Automatic Updates

* Disable Automatic Updates

* Reference

* 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

* Manage Installation

* Other Configuration Guides

* Configure HTTP/HTTPS Proxy
On this page
Configure HTTP/HTTPS Proxy

When Appsmith runs behind a corporate firewall or a Virtual Private Network (VPN), it may require proxy settings to access the internet and communicate with cs.appsmith.com . This page shows how to set up HTTP/HTTPS proxy on your self-hosted Appsmith instance so that you can access Appsmith using a proxy.

Prerequisites 

* Self-hosted Appsmith instance. If not installed yet, see the installation guides for installing Appsmith.

Verify connectivity 

Before you begin proxy configuration, verify whether your Appsmith instance can connect to cs.appsmith.com for internal communication. See Verify connectivity to cs.appsmith.com for Docker and Kubernetes test steps.

For Docker, connect to the container and run:

docker exec -it -u root appsmith bash
curl -i -v https://cs.appsmith.com/api/v1/health

If you see connection errors (for example, Connection timed out or Network unreachable ), a proxy setup may be required.

Set up proxy 

Follow below steps to configure proxy by setting environment variables:

*
Open the Appsmith installation configuration file:

* Docker: docker.env

* Kubernetes: values.yaml

*
Use any one of the below pair of environment variables to set proxy:

* HTTP_PROXY and HTTPS_PROXY (uppercase)

* http_proxy and https_proxy (lowercase)

For example, set up proxy using uppercase environment variables:

HTTP_PROXY=http://1.2.3.4:8080
HTTPS_PROXY=http://1.2.3.4:8080

*
Save the file and restart Appsmith instance.

*
Confirm proxy configuration with:

curl -i -v https://cs.appsmith.com/api/v1/health

*
When using an HTTPS proxy, you may want to add a trusted custom Certificate Authority to Appsmith. For more information, see Custom Root CA Certificate guide.

Troubleshooting 

You may face some common issues while configuring the proxy. Troubleshoot by:

* Verifying the proxy address and port.

* Confirming that you've set up correct environment variables.

* Reviewing the network or firewall settings.

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

Was this page helpful?

Edit this page

Previous
Configure PostgreSQL for SAML SSO (Azure)
Next
Configure Environment Variables

* Prerequisites

* Verify connectivity

* Set up proxy

* Troubleshooting
Configure HTTP/HTTPS Proxy | Appsmith

Links found on this page
