1
0
Fork 0
mirror of synced 2024-05-24 06:29:47 +12:00
appwrite/README.md

103 lines
6.6 KiB
Markdown
Raw Normal View History

2019-05-24 17:33:10 +12:00
<p align="center">
2019-08-28 01:59:43 +12:00
<a href="https://appwrite.io" target="_blank"><img width="260" height="39" src="https://appwrite.io/images/github-logo.png" alt="Appwrite Logo"></a>
2019-05-24 17:33:10 +12:00
<br />
<br />
<b>Simple Backend Server for your [Vue / Angular / React / iOS / Android / Flutter / *ANY*] Frontend App</b>
<br />
<br />
</p>
2019-08-03 18:09:40 +12:00
[![Docker Pulls](https://img.shields.io/docker/pulls/appwrite/appwrite.svg)](https://hub.docker.com/r/appwrite/appwrite)
2019-08-26 02:16:31 +12:00
[![Chat With Us](https://img.shields.io/gitter/room/appwrite/community.svg)](https://gitter.im/appwrite/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link)
2019-09-14 20:51:01 +12:00
[![Build Status](https://travis-ci.org/appwrite/appwrite.svg?branch=master)](https://travis-ci.org/appwrite/appwrite)
2019-08-31 06:12:48 +12:00
[![Follow Appwrite on StackShare](https://img.stackshare.io/misc/follow-on-stackshare-badge.svg)](https://stackshare.io/appwrite)
2019-05-24 17:33:10 +12:00
---
2019-09-20 17:27:49 +12:00
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 aims to make developers life a lot easier by hiding the complexity of common and repetitve software development tasks.
2019-05-24 17:33:10 +12:00
Using Appwrite you can easily manage user authentication with multiple sign-in methods, database for storing and querying user and teams data, storage and file management, image manipulation and cropping, scheduled cron tasks and many other features to help you get more results in faster times and with a lot less code.
2019-08-26 02:16:51 +12:00
[https://appwrite.io](https://appwrite.io)
2019-08-26 02:16:31 +12:00
2019-05-24 17:33:10 +12:00
![Appwrite](public/images/github.png)
## 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 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:
```bash
2019-08-25 07:17:22 +12:00
mkdir appwrite-ce && \
cd appwrite-ce && \
2019-09-04 01:28:09 +12:00
curl -o docker-compose.yml https://appwrite.io/docker-compose.yml?port=80 && \
2019-08-25 07:17:22 +12:00
docker-compose up -d --remove-orphans
2019-05-24 17:33:10 +12:00
```
2019-09-22 00:26:20 +12:00
Once the Docker installation completes, go to http://localhost to access the Appwrite console from your browser. Please notice that on non-linux native hosts the server might take a few minutes to start after installation completes.
For advanced, production and custon installation check out our Docker [enviornemnt variables](/docs/EnviornementVariables.md) docs.
For complete API documentation, visit [https://appwrite.io/docs](https://appwrite.io/docs)
2019-08-25 05:47:35 +12:00
2019-09-04 01:28:09 +12:00
### Changing Port Number
In case your port 80 is already taken, change the port number in the command above. Make sure to set the correct endpoint in your selected SDK, including your new port number.
2019-05-24 17:33:10 +12:00
## Getting Started
2019-09-11 06:31:17 +12:00
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.
2019-05-24 17:33:10 +12:00
* [Getting Started for Web](https://appwrite.io/docs/getting-started-for-web)
* Getting Started for Android (soon...)
* Getting Started for iOS (soon...)
* [Getting Started for Server](https://appwrite.io/docs/getting-started-for-server)
2019-08-05 16:03:18 +12:00
### Services
2019-05-24 17:33:10 +12:00
2019-08-05 16:00:28 +12:00
* [**Auth**](https://appwrite.io/docs/auth) - Manage user authentication using multiple signin methods and account recovery.
* [**Account**](https://appwrite.io/docs/account) - Manage current user account. Track and manage the user sessions, devices and security audit log.
* [**Users**](https://appwrite.io/docs/users) - Manage and list all project users when in admin mode.
* [**Teams**](https://appwrite.io/docs/teams) - Manage and group users in teams. Manage memberships, invites and users roles within a team.
* [**Database**](https://appwrite.io/docs/database) - Manage database collections and document. Read, create, update and delete documents and filter lists of documents collections using advanced filter with graph like capabilities.
* [**Storage**](https://appwrite.io/docs/storage) - Manage storage files. Read, create, delete and preview files. Manipulate your files preview to fit your app perfectly. All files are scanned by ClamAV and stored in a secure and encrypted way.
* [**Locale**](https://appwrite.io/docs/locale) - Track users location, and manage your app locale based data.
* [**Avatars**](https://appwrite.io/docs/avatars) - Manage your users avatars, countries flags, browser icons, credit card symbols and generate QR codes.
2019-05-24 17:33:10 +12:00
2019-08-05 16:03:18 +12:00
### SDKs
2019-05-24 17:33:10 +12:00
Currently we are supporting a few SDK libraries and we are constantly working on adding 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](https://github.com/appwrite/sdk-generator) project and view our contribution guide.
2019-08-25 08:39:20 +12:00
* ✅ [JS](https://github.com/appwrite/sdk-for-js) (Maintained by the Appwrite Team)
2019-08-05 15:54:09 +12:00
* ✅ [PHP](https://github.com/appwrite/sdk-for-php) (Maintained by the Appwrite Team)
2019-08-25 08:39:20 +12:00
* ✅ [NodeJS](https://github.com/appwrite/sdk-for-node) (Maintained by the Appwrite Team)
* ✅ [Ruby](https://github.com/appwrite/sdk-for-ruby) - **Work in progress** (Maintained by the Appwrite Team)
2019-08-25 05:47:35 +12:00
* ✅ [Python](https://github.com/appwrite/sdk-for-python) - **Work in progress** (Maintained by the Appwrite Team)
* ✳️ Looking for more SDKs? - Help us by contributing a pull request to our [SDK Generator](https://github.com/appwrite/sdk-generator)!
2019-05-24 17:33:10 +12:00
2019-09-27 17:48:05 +12:00
## Security
For security issues, please email [security@appwrite.io](mailto:security@appwrite.io) instead of posting a public issue in GitHub.
2019-09-27 17:51:22 +12:00
## Follow Us
2019-09-27 17:48:05 +12:00
Join our growing commuinty around the world! Follow us on both [Twitter](https://twitter.com/appwrite_io), [Facebook Page](https://www.facebook.com/appwrite.io), [Facebook Group](https://www.facebook.com/groups/appwrite.developers/) or join our live [Gitter community](https://gitter.im/appwrite/community) for more help, ideas and discussions.
2019-05-24 17:33:10 +12:00
## 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.
2019-09-20 17:29:03 +12:00
We really ❤️ pull requests! If you wish to help, you can learn more about how you can contribute to this project in the [contribution guide](CONTRIBUTING.md).
2019-09-20 16:45:48 +12:00
2019-09-27 17:51:22 +12:00
## Credits
2019-09-27 17:48:05 +12:00
Created by [Eldad Fux](https://twitter.com/eldadfux) with the amazing help of our **amazing contributors:**
2019-05-24 17:33:10 +12:00
2019-09-27 17:48:05 +12:00
* 🇺🇸Justin Dorfman ([Github](https://github.com/@jdorfman), [Twitter](https://twitter.com/jdorfman))
2019-09-27 17:49:22 +12:00
* 🇺🇳0xflotus ([Github](https://github.com/0xflotus))
* 🇳🇴Chaaarles ([Github](https://github.com/Chaaarles))