Simple Backend Server for your [Flutter / Vue / Angular / React / iOS / Android / *ANY OTHER*] Frontend App
Appwrite is a simple self-hosted backend server for web and mobile developers with a shiny dashboard and a very easy-to-use REST API.
Appwrite API services aim to make developer's life a lot easier by hiding the complexity of common and repetitive software development tasks.
Using Appwrite, you can easily manage user authentication with multiple sign-in methods, a database for storing and querying user and team data, storage and file management, image manipulation and cropping, schedule cron tasks and many other features to help you get more results in faster times and with a lot less code.
Appwrite can also integrate really well with your backend. Appwrite can work behind your own proxy facing your internal network, or alongside your own custom backend. You can use Appwrite server SDK to integrate your backend with Appwrite's APIs and webhooks.
Table of Contents:
Installation
Appwrite backend server is designed to run in a container environment. Running your server is as easy as running one command from your terminal. You can either run Appwrite on your localhost using docker-compose or on any other container orchestration tool like Kubernetes, Docker Swarm or Rancher.
The easiest way to start running your Appwrite server is by running our docker-compose file. Before running the installation command make sure you have Docker installed on your machine:
Unix
docker run -it --rm \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$(pwd)"/appwrite:/install/appwrite:rw \
-e version=0.6.1 \
appwrite/install
Windows
CMD
docker run -it --rm ^
--volume //var/run/docker.sock:/var/run/docker.sock ^
--volume "%cd%"/appwrite:/install/appwrite:rw ^
-e version=0.6.1 ^
appwrite/install
PowerShell
docker run -it --rm ,
--volume /var/run/docker.sock:/var/run/docker.sock ,
--volume ${pwd}/appwrite:/install/appwrite:rw ,
-e version=0.6.1 ,
appwrite/install
Once the Docker installation completes, go to http://localhost to access the Appwrite console from your browser. Please note that on non-linux native hosts, the server might take a few minutes to start after installation completes.
For advanced production and custom installation, check out our Docker environment variables docs.
Getting Started
Getting started with Appwrite is as easy as creating a new project, choosing your platform and integrating its SDK in your code. You can easily get started with your platform of choice by reading one of our Getting Started tutorials.
- Getting Started for Web
- Getting Started for Flutter
- Getting Started for Server
- Getting Started for Android (soon...)
- Getting Started for iOS (soon...)
Services
- Account - Manage current user authentication and account. Track and manage the user sessions, devices, sign-in methods, and security logs.
- Users - Manage and list all project users when in admin mode.
- Teams - Manage and group users in teams. Manage memberships, invites, and user roles within a team.
- Database - Manage database collections and documents. Read, create, update, and delete documents and filter lists of documents collections using an advanced filter with graph-like capabilities.
- Storage - Manage storage files. Read, create, delete, and preview files. Manipulate the preview of your files to fit your app perfectly. All files are scanned by ClamAV and stored in a secure and encrypted way.
- Locale - Track your user's location, and manage your app locale-based data.
- Avatars - Manage your users' avatars, countries' flags, browser icons, credit card symbols, and generate QR codes.
For the complete API documentation, visit https://appwrite.io/docs. For more tutorials, news and announcements check out our blog.
SDKs
Currently, we support only a few SDK libraries and are constantly working on including new ones.
Below is a list of currently supported platforms and languages. If you wish to help us add support to your platform of choice, you can go over to our SDK Generator project and view our contribution guide.
Client
Server
✅ NodeJS (Maintained by the Appwrite Team)✅ PHP (Maintained by the Appwrite Team)✅ Ruby - Beta (Maintained by the Appwrite Team)✅ Python - Beta (Maintained by the Appwrite Team)✅ Go Work in progress (Maintained by the Appwrite Team)✅ Dart Work in progress (Maintained by the Appwrite Team)
Looking for more SDKs? - Help us by contributing a pull request to our SDK Generator!
Security
For security issues, kindly email us security@appwrite.io instead of posting a public issue in GitHub.
Follow Us
Join our growing community around the world! Follow us on Twitter, Facebook Page, Facebook Group or join our live Discord server for more help, ideas, and discussions.
Contributing
All code contributions - including those of people having commit access - must go through a pull request and approved by a core developer before being merged. This is to ensure proper review of all the code.
We truly
License
This repository is available under the BSD 3-Clause License.