talk to us on WhatsApp now

Knowledgebase

  1. The Right Partner in Hosting
  2. Knowledgebase
  3. AppStore
  4. Appwrite

  Tag Cloud

2FA API Backup ceph client create database Domain Email hosting How to Install an SSL Certificate (AutoSSL) in CWP How to Search for a Knowledge Base Article How to View Your Domain’s WHOIS Information How to View Your Server Task History Login MariaDB Non Linux S3 client Partner hub partnerhub PhpMyAdmin Proxmox reseller RocksDB S3 S3 Client S3 mobile client setup Storage Ubuntu VM wordpress

  Support

  My Support Tickets   Announcements   Knowledgebase   Downloads   Network Status   Open Ticket

Appwrite Print

  • 0

 

 

 

How to Install Appwrite with Docker on Ubuntu 24.04

 

Appwrite with Docker on Ubuntu 24.04 (Nginx + SSL)

Appwrite is a secure, self-hosted backend-as-a-service (BaaS) platform designed to speed up app development. It provides a full suite of backend APIs — including authentication, databases, storage, functions, and real-time APIs — all accessible through REST or GraphQL. With Appwrite, developers can focus on building frontends while relying on a powerful, ready-to-use backend.

Running Appwrite with Docker ensures simple deployment and consistent environments, since all services (API server, database, queue, storage) are containerized. With Ubuntu 24.04 LTS (Noble Numbat), you get a modern, secure, and long-supported foundation, featuring systemd 255, updated OpenSSL 3, and the latest Docker packages — perfect for production-grade deployments.

Architecture Overview

Layer Component Role
OS Ubuntu 24.04 LTS Stable, secure foundation with long-term support
Runtime Docker Engine + Compose Runs Appwrite’s multi-container stack
Application Appwrite Core Services Provides APIs for auth, DB, storage, functions, messaging, and more
Database MariaDB (default) / PostgreSQL Stores user data, projects, configs
Cache/Queue Redis Caching and background task management
Reverse Proxy Nginx (built-in container) TLS termination, routing, load handling
TLS Let’s Encrypt / PKI HTTPS access for APIs and Appwrite console

Why Use Appwrite?

  • Backend-as-a-Service – instantly get APIs for auth, DB, storage, and functions.
  • Self-hosted – keep full control of your data, unlike SaaS BaaS solutions (Firebase, Supabase cloud).
  • Modern APIs – REST and GraphQL endpoints for easy frontend integration.
  • Secure & extensible – RBAC, OAuth2, JWT tokens, rate limiting, and custom cloud functions.
  • Docker-first deployment – consistent, easy to set up, scale, and maintain.

Security & Best Practices

  • Always run Appwrite behind HTTPS; Let’s Encrypt integration is supported.
  • Store secrets in environment variables; avoid committing .env files.
  • Restrict external exposure with UFW/nftables, allowing only ports 80/443.
  • Use RBAC and JWT-based tokens to secure APIs.
  • Keep Docker images (appwrite/appwrite, redis, mariadb) updated.
  • Use external object storage (MinIO, S3, GCS) for production-grade file hosting.
  • Enable logging, monitoring, and automated backups of the database.

Typical Use Cases

  • Web and mobile apps needing backend APIs without building from scratch.
  • Firebase alternative for teams who need data sovereignty.
  • Prototyping and MVPs with rapid backend setup.
  • Enterprise apps that require on-premises control and compliance.
  • Custom SaaS platforms built on top of Appwrite APIs.

1. Connect to Your VPS

On Linux/macOS

ssh root@your-server-ip

On Windows

  • On Windows 10/11 PowerShell: ssh root@your-server-ip
  • On older Windows, install PuTTY and log in as root using your server IP.

2. Update System and Install Prerequisites

Update repositories:

apt update

Upgrade installed packages:

apt upgrade

Install required tools:

apt install apt-transport-https ca-certificates curl gnupg lsb-release

3. Install Docker and Docker Compose

Add Docker’s GPG key:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

Add Docker repository for Ubuntu 24.04 (Noble):

echo "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/ubuntu noble stable" > /etc/apt/sources.list.d/docker.list

Update repositories and install Docker:

apt update
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Enable and start Docker:

systemctl enable --now docker

Verify versions:

docker --version
docker compose version

4. Install Appwrite

Create Appwrite directory:

mkdir -p /opt/appwrite
cd /opt/appwrite

Run the Appwrite installation container:

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:latest

This generates the docker-compose.yml and .env files.

Generate a secure OpenSSL key:

openssl rand -base64 32

Check generated files:

ls -l /opt/appwrite/appwrite

You should see docker-compose.yml, .env, and related config files.

5. Configure Appwrite

Edit the .env file:

nano /opt/appwrite/appwrite/.env

Update these values:

_APP_ENV=production
_APP_OPENSSL_KEY_V1=PasteTheKeyYouGenerated
_APP_DOMAIN=appwrite.example.com
_APP_DOMAIN_TARGET=appwrite.example.com
_APP_ADMIN_EMAIL=admin@example.com
_APP_ADMIN_NAME=Administrator

6. Start Appwrite

Move into the Appwrite directory:

cd /opt/appwrite/appwrite

Start services:

docker compose up -d

Check container status:

docker compose ps

View logs:

docker compose logs --no-color --tail=200

7. Access Appwrite

Now open your browser and visit:

http://appwrite.example.com

 

Was this answer helpful?
Back