Appwrite is a free and open-source back-end server that offers core APIs required to build any application packaged together as a set of easy-to-use Docker containers. It helps mobile developers to build advanced apps much faster. Appwrite saves you 70% of the time and costs required for building a modern application. It offers a simple and user-friendly web interface that helps you to track your backend API usage and manage your project resources from a web browser.
In this post, we will show you how to install Appwrite server with Docker on Ubuntu 22.04.
Prerequisites
- A server running Ubuntu 22.04.
- A root password is configured on the server.
Add Docker Repository
By default, the latest version of Docker is not available in the Ubuntu default repository. So you will need to install it from Docker's official repository:
First, install all the required dependencies with the following command:
apt install apt-transport-https ca-certificates curl software-properties-common -y
Once all the packages are installed, download and add the Docker GPG key using the following command:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
Next, add the Docker official repository with the following command:
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu jammy stable"
Once the Docker repository is added, you can verify the added repository using the following command:
apt-cache policy docker-ce
You will get the following output:
docker-ce:
Installed: (none)
Candidate: 5:20.10.17~3-0~ubuntu-jammy
Version table:
5:20.10.17~3-0~ubuntu-jammy 500
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
5:20.10.16~3-0~ubuntu-jammy 500
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
5:20.10.15~3-0~ubuntu-jammy 500
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
5:20.10.14~3-0~ubuntu-jammy 500
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
5:20.10.13~3-0~ubuntu-jammy 500
500 https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
Install Docker CE
Now, install the Docker CE package by running the following command:
apt install docker-ce -y
Once the Docker CE is installed, you can verify the Docker CE version with the following command:
docker --version
You should see the following output:
Docker version 20.10.17, build 100c701
You can also verify the status of the Docker with the following command:
systemctl status docker
You should see the following output:
? docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Sun 2022-08-28 05:52:18 UTC; 47s ago
TriggeredBy: ? docker.socket
Docs: https://docs.docker.com
Main PID: 2719 (dockerd)
Tasks: 7
Memory: 30.3M
CPU: 312ms
CGroup: /system.slice/docker.service
??2719 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.379341986Z" level=info msg="scheme \"unix\" not registered, fallback to d>
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.379467088Z" level=info msg="ccResolverWrapper: sending update to cc: {[{u>
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.379593467Z" level=info msg="ClientConn switching balancer to \"pick_first>
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.427861369Z" level=info msg="Loading containers: start."
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.620267088Z" level=info msg="Default bridge (docker0) is assigned with an >
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.713742709Z" level=info msg="Loading containers: done."
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.744925054Z" level=info msg="Docker daemon" commit=a89b842 graphdriver(s)=>
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.745338168Z" level=info msg="Daemon has completed initialization"
Aug 28 05:52:18 ubuntu2204 systemd[1]: Started Docker Application Container Engine.
Aug 28 05:52:18 ubuntu2204 dockerd[2719]: time="2022-08-28T05:52:18.805663866Z" level=info msg="API listen on /run/docker.sock"
Install Appwrite on Ubuntu 22.04
You can now install the Appwrite by running the following command:
docker run -it --rm --volume /var/run/docker.sock:/var/run/docker.sock --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw --entrypoint="install" appwrite/appwrite:0.12.1
This command will download all required images for Appwrite and create a container. During the process, you will be asked to choose your HTTP and HTTPS server port:
83577bffd893: Pull complete 9722b4cda70e: Pull complete bede3c89f2f3: Pull complete 0bb0dd9a25cc: Pull complete d431a0cda7a4: Pull complete bd9edd8b939c: Pull complete 24ccf9e70cfd: Pull complete bc8aa3e29770: Pull complete 4ee3909c4974: Pull complete 359c5d4ab0a2: Pull complete 97ffe4879aea: Pull complete 42e96d223d26: Pull complete c12fc543b73f: Pull complete e25a36152792: Pull complete e672f91535ad: Pull complete f4a1c11b6f1d: Pull complete 9df8264116e7: Pull complete f3c7599812dd: Pull complete cf51f2dd9e94: Pull complete Digest: sha256:ddc9e53482252df4eb2e0ff90a7efff6cec5346b34240f664ac24e582dc65071 Status: Downloaded newer image for appwrite/appwrite:0.12.1 Starting Appwrite installation... Choose your server HTTP port: (default: 80) Choose your server HTTPS port: (default: 443) Choose a secret API key, make sure to make a backup of your key in a secure location (default: 'your-secret-key')
Provide your preferred ports and press the Enter key. You will be asked to provide your Appwrite hostname:
Enter your Appwrite hostname (default: 'localhost') appwrite.example.com Provide your hostname and press the Enter key. Once the Appwrite has been installed, you will get the following output: 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') appwrite.example.com Running "docker-compose -f /usr/src/code/appwrite/docker-compose.yml up -d --remove-orphans --renew-anon-volumes" Appwrite installed successfully
You can now verify all downloaded Docker images with the following command:
docker images
You will get the following output:
REPOSITORY TAG IMAGE ID CREATED SIZE mariadb 10.7 b0408ef424b9 4 days ago 415MB traefik 2.5 865923368a9f 7 months ago 101MB appwrite/appwrite 0.12.1 5dd87572d61b 7 months ago 492MB appwrite/runtime-for-java 16.0 80cb53a883d9 14 months ago 327MB appwrite/runtime-for-node 16.0 dd69334e816d 14 months ago 116MB appwrite/runtime-for-ruby 3.0 553408e76d3d 14 months ago 62.6MB appwrite/runtime-for-python 3.9 98f1967126b5 14 months ago 47.6MB appwrite/runtime-for-php 8.0 e6c8c40bd069 14 months ago 86.3MB appwrite/telegraf 1.2.0 b524e292d428 15 months ago 127MB redis 6.0-alpine3.12 933c79ea2511 19 months ago 31.6MB appwrite/influxdb 1.0.0 8c1dd387596e 22 months ago 248MB
You can see all the running containers using the following command:
docker ps
You will get a list of all running containers in the following output:
NAMES a496ce91c5ed traefik:2.5 "/entrypoint.sh --pr…" 33 seconds ago Up 30 seconds 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp appwrite-traefik 36c7df33b630 appwrite/appwrite:0.12.1 "worker-database" 44 seconds ago Up 33 seconds 80/tcp appwrite-worker-database 66e36ce68586 appwrite/appwrite:0.12.1 "worker-functions" 45 seconds ago Up 33 seconds 80/tcp appwrite-worker-functions 5011d448b1ed appwrite/appwrite:0.12.1 "realtime" 45 seconds ago Up 33 seconds 80/tcp appwrite-realtime 84e117d48e23 appwrite/appwrite:0.12.1 "docker-php-entrypoi…" 45 seconds ago Up 33 seconds 80/tcp appwrite 95465c386e19 appwrite/appwrite:0.12.1 "worker-audits" 45 seconds ago Up 34 seconds 80/tcp appwrite-worker-audits c0ddb48e3d0c appwrite/appwrite:0.12.1 "worker-certificates" 45 seconds ago Up 33 seconds 80/tcp appwrite-worker-certificates 0cc2c6f401d8 appwrite/appwrite:0.12.1 "worker-webhooks" 45 seconds ago Up 33 seconds 80/tcp appwrite-worker-webhooks 47a519fa6e6d appwrite/appwrite:0.12.1 "worker-deletes" 45 seconds ago Up 37 seconds 80/tcp appwrite-worker-deletes af354030c8f7 appwrite/appwrite:0.12.1 "usage" 45 seconds ago Up 37 seconds 80/tcp appwrite-usage f25b1832b3bc appwrite/appwrite:0.12.1 "schedule" 46 seconds ago Up 40 seconds 80/tcp appwrite-schedule f5c7c025ecb3 appwrite/appwrite:0.12.1 "maintenance" 46 seconds ago Up 41 seconds 80/tcp appwrite-maintenance e25d6b28b033 appwrite/appwrite:0.12.1 "worker-mails" 46 seconds ago Up 38 seconds 80/tcp appwrite-worker-mails 1c927b29732f appwrite/telegraf:1.2.0 "/entrypoint.sh tele…" 48 seconds ago Up 45 seconds 8092/udp, 8125/udp, 8094/tcp appwrite-telegraf 7d8e644afba3 mariadb:10.7 "docker-entrypoint.s…" 48 seconds ago Up 45 seconds 3306/tcp appwrite-mariadb 21e8c76c53a0 appwrite/influxdb:1.0.0 "/entrypoint.sh infl…" 48 seconds ago Up 46 seconds 8086/tcp appwrite-influxdb 5b136250c71f redis:6.0-alpine3.12 "docker-entrypoint.s…" 48 seconds ago Up 46 seconds 6379/tcp appwrite-redis
Access Appwrite Web Interface
Now, open your web browser and access the Appwrite web interface using the URL https://appwrite.example.com. You will be redirected to the Appwrite Sign Up page:
Provide your name, email address, password and click on the Sign Up button. You should see the Appwrite dashboard on the following page:
Click on the Create Project button to create your first project. You should see the following page:
Provide your Project ID, Project name and click on the Create button. You will get into your project page:
Now, you will need to add a platform to build your application. Click on the Add Platform button. You should see the following page:
Provide your appname, hostname and click on the Register button. You should see the following page:
Conclusion
Congratulations! you have successfully installed Appwrite with Docker on Ubuntu 22.04. You can now deploy your first web or mobile application on the Appwrite platform. Feel free to ask me if you have any questions.