DEV Community

Cover image for Deploy Appwrite using docker on GitPod & Azure
Sahil Patel
Sahil Patel

Posted on • Updated on • Originally published at

Deploy Appwrite using docker on GitPod & Azure

I have started building my web app using Appwrite as a backend service for the Hackathon on Most of the time I work with cloud platforms which are accessible on the internet for development and testing, like firebase and Supabase or my own cloud server. Appwrite has its own cloud platform upcoming. There are other options like Gitpod and Digital Ocean to deploy your app. I have deployed Appwrite on Gitpod which is just one click long process and on Azure Virtual Machine.

I looked up on Google how to install Appwrite on Azure but no article came up or something that is helping. So I tried on my own using the Azure App Service but no luck after changing many configs.

Appwrite has option to deploy an instance on Gitpod. I have used it and trust me it is an awesome service providing the installation of the Appwrite. Below are the 2 ways to deploy Appwrite on the internet.

Deploy Appwrite For Free on Gitpod

Gitpod's free plan should be just fine for you to fire up and running your Appwrite deployment. There are some limitations to free plan. You can only have 50 hours of running it every month. I think this is a very generous plan for development and testing.

1. Create an account on Gitpod

Here is the link to signup for Gitpod. Gitpod Home Page Gitpod Pricing

Gitpod dash

Sign up and you will be redirected to the workspace.

Gitpod Workspace

Step 2: Deploy Appwrite

Once account is up and running, make sure you are logged in and go to the installation docs. Appwrite Installation Docs

Scroll down and find "one click setups" section.

Appwrite Docs

Click on "Click to install" link for Gitpod. Now behind the scenes Gitpod will fetch the docker yaml configuration from the Github repo and and pull the image from docker as well set it up.

Gitpod Project

You may see a screen like this once the deploy is finished. On the right hand, in the simple browser window, open the URL link into another tab, create account and you are good to go.

Deploy Appwrite with Azure

Azure will cost you money to host Appwrite on Cloud VM. Feel free to use Gitpod instead.

Get Your Virtual Machine Ready

  1. Go to Azure Portal. Link - Azure portal
  2. Create an account if you do not have one.
  3. You will be landed on the home page of the portal like below.

Azure Portal

  1. Choose Virtual Machines and go ahead.
  2. This screen will show all the deployed instances.

Create Instance

  1. Click Create to create a new VM.


  1. Choose the second option, Azure Virtual Machine with preset configuration to create a new VM using preset.
  2. You will be asked to choose different environment based on the need but just skip it. You will find a Skip for now button down somewhere.
  3. Now, lets create the VM for out needs.

Choose the subscription and the resource group first, create if you do not have it.

Create install

Fill up the details based on your needs. Below is my configuration.

  • Choose the Virtual Machine Name - appwrite
  • Choose the region - Canada (Canada Central) - It should be the nearest
  • Availability Options - No infrastructure redundancy required
  • Security - Standard
  • Image: Ubuntu Server 20.04 LTS - Gen2
  • Azure Spot - Unchecked
  • Size - Standard_B2s, 2vcps 4 GiB Memeory - I heard someone saying it automatically kills the setup of appwrite if the minimum RAM size is less than 2 GB. So that is the reason for choosing the Standard B2.
  • Administration type - You can go ahead and use SSH as the login type but I prefer it with username and password.
  • Now click Review + Create .
  • Azure will validate everything and then show you all the information filled.
  • Review it and click on create. It will start the process of deployment of your VM on Azure cloud.
  • Once the VM is ready, go to the VM's resource and copy the public IP address. Make sure to make it static and not dynamic.
  1. Connect to your instance.
    • Download and Install Putty
    • Add the IP address copied and click Open.
    • Putty will prompt for credentials. Enter credentials and click enter.
    • If everything would be okay so far then you will be logged into the instance with sudo permissions.

Putty Image

  1. Time to add docker to the VM.
  2. Run commands below to install docker on your VM step by step.

Check out this link for in detail information about these commands.

#Update the list of packages
sudo apt update

#Instll prerequisite packages
sudo apt install apt-transport-https ca-certificates curl software-properties-common

#Add GPG key for the official docker repo
curl -fsSL | sudo apt-key add -

#Add the docker repo of apt sources
sudo add-apt-repository "deb [arch=amd64] focal stable"

#Install docker
sudo apt install docker-ce

#Check status of docker daemon
sudo systemctl status docker    
Enter fullscreen mode Exit fullscreen mode
  1. Run the command to install appwrite.

    docker run -it --rm \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \

Note: If you find the error below, do these steps.

docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/create": dial unix /var/run/docker.sock: connect: permission denied.
See 'docker run --help'.
Enter fullscreen mode Exit fullscreen mode

Run these command and then run the installation command again. For more details on these commands, check out this stack overflow question.

$ sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
docker run hello-world # if docker runs the hello-world image then you are good to go.
Enter fullscreen mode Exit fullscreen mode

Run the installation command again and there should be no problems.

Once Docker has successfully pulled the image from the hub it will ask some of the questions, which are as below :

  1. Choose your server HTTP port: (default: 80)
    Ans: Keep it default.

  2. Choose your server HTTPS port: (default: 443)
    Ans: Keep it default.

  3. Choose a secret API key, make sure to make a backup of your key in a secure location (default: 'your-secret-key')
    Ans: Keep it default.

  4. Enter your Appwrite hostname (default: 'localhost')
    Ans: Enter the public IP address of your VM instance

  5. Enter a DNS A record hostname to serve as a CNAME for your custom domains.
    You can use the same value as used for the Appwrite hostname. (default: 'localhost')
    Ans: Again, Enter the public IP address of your VM instance

Once you click ok, it will run docker-compose and set up the config for appwrite,

Success Message

Once done, You will see a message that "Appwrite Installed Successfully."
Now, to access the Appwrite console go to the public IP address of your VM and you should see the screen like below. Create an account and start building using Appwrite.

Appwrite Login Page

Discussion (4)

devyaz profile image

Awesome, I just did that 3days ago, am learning Appwrite, I've come to know of the 50hr pm from you🤭

smppatel99999 profile image
Sahil Patel Author

I used to keep toggling the instance on and off to save hours so I could do more code. Happy hacking! 😊

eldadfux profile image
Eldad A. Fux

Cool tutorial!

smppatel99999 profile image
Sahil Patel Author

Thanks Eldad.