|
1 |
| -## parse-server |
| 1 | +<img src="http://parse.com/assets/svgs/parse-infinity.svg" alt="Parse logo" height="70"/> |
| 2 | + |
| 3 | +## Parse Server |
2 | 4 |
|
3 | 5 | [](https://travis-ci.org/ParsePlatform/parse-server)
|
4 | 6 | [](https://codecov.io/github/ParsePlatform/parse-server?branch=master)
|
5 | 7 | [](https://www.npmjs.com/package/parse-server)
|
6 | 8 |
|
7 |
| -A Parse.com API compatible router package for Express |
| 9 | +Parse Server is an open source version of the Parse backend that can be deployed to any infrastructure that can run Node.js. |
| 10 | + |
| 11 | +Parse Server works with the Express web application framework. It can be added to existing web applications, or run by itself. |
8 | 12 |
|
9 | 13 | Read the announcement blog post here: http://blog.parse.com/announcements/introducing-parse-server-and-the-database-migration-tool/
|
10 | 14 |
|
11 |
| -Read the migration guide here: https://parse.com/docs/server/guide#migrating |
| 15 | +## Documentation |
| 16 | + |
| 17 | +Documentation for Parse Server is available in the [wiki](https://github.com/ParsePlatform/parse-server/wiki) for this repository. The [Parse Server guide](https://github.com/ParsePlatform/parse-server/wiki/Parse-Server-Guide) is a good place to get started. |
| 18 | + |
| 19 | +If you're interested in developing for Parse Server, the [Development guide](https://github.com/ParsePlatform/parse-server/wiki/Development-Guide) will help you get set up. |
| 20 | + |
| 21 | +### Example Project |
| 22 | + |
| 23 | +Check out the [parse-server-example project](https://github.com/ParsePlatform/parse-server-example) repository for an example of a Node.js application that uses the parse-server module on Express. |
| 24 | + |
| 25 | +### Migration Guide |
| 26 | + |
| 27 | +Migrate your existing Parse apps to your own Parse Server. The hosted version of Parse will be fully retired on January 28th, 2017. If you are planning to migrate an app, you need to begin work as soon as possible. Learn more in the [Migration guide](https://github.com/ParsePlatform/parse-server/wiki/Migrating-an-Existing-Parse-App). |
12 | 28 |
|
13 |
| -There is a development wiki here on GitHub: https://github.com/ParsePlatform/parse-server/wiki |
14 | 29 |
|
15 |
| -We also have an [example project](https://github.com/ParsePlatform/parse-server-example) using the parse-server module on Express. |
16 | 30 |
|
17 | 31 | ---
|
18 | 32 |
|
| 33 | + |
19 | 34 | #### Basic options:
|
20 | 35 |
|
21 | 36 | * databaseURI (required) - The connection string for your database, i.e. `mongodb://user:[email protected]/dbname`
|
@@ -74,7 +89,7 @@ It is possible to leverage the OAuth support with any 3rd party authentication t
|
74 | 89 |
|
75 | 90 | oauth: {
|
76 | 91 | my_custom_auth: {
|
77 |
| - module: "PATH_TO_MODULE" // OR object, |
| 92 | + module: "PATH_TO_MODULE" // OR object, |
78 | 93 | option1: "",
|
79 | 94 | option2: "",
|
80 | 95 | }
|
@@ -141,12 +156,12 @@ app.listen(port, function() {
|
141 | 156 |
|
142 | 157 | You can configure the Parse Server with environment variables:
|
143 | 158 |
|
144 |
| -```js |
| 159 | +```js |
145 | 160 | PARSE_SERVER_DATABASE_URI
|
146 | 161 | PARSE_SERVER_CLOUD_CODE_MAIN
|
147 | 162 | PARSE_SERVER_COLLECTION_PREFIX
|
148 | 163 | PARSE_SERVER_APPLICATION_ID // required
|
149 |
| -PARSE_SERVER_CLIENT_KEY |
| 164 | +PARSE_SERVER_CLIENT_KEY |
150 | 165 | PARSE_SERVER_REST_API_KEY
|
151 | 166 | PARSE_SERVER_DOTNET_KEY
|
152 | 167 | PARSE_SERVER_JAVASCRIPT_KEY
|
@@ -192,3 +207,7 @@ You can also set up an app on Parse, providing the connection string for your mo
|
192 | 207 | ### Not supported
|
193 | 208 |
|
194 | 209 | * `Parse.User.current()` or `Parse.Cloud.useMasterKey()` in cloud code. Instead of `Parse.User.current()` use `request.user` and instead of `Parse.Cloud.useMasterKey()` pass `useMasterKey: true` to each query. To make queries and writes as a specific user within Cloud Code, you need the user's session token, which is available in `request.user.getSessionToken()`.
|
| 210 | + |
| 211 | +## Contributing |
| 212 | + |
| 213 | +We really want Parse to be yours, to see it grow and thrive in the open source community. Please see the [Contributing to Parse Server guide](CONTRIBUTING.md). |
0 commit comments