Files
supabase/web/docs/realtime/server/aws.md
T
Copple a788003648 Documentation for the new DX (#253)
## What kind of change does this PR introduce?

Updates the docs with the new developer experience: https://deploy-preview-253--supabase.netlify.app/docs

- Documents the new Auth using `gotrue-js`
- Fixes #179 
- Fixes OAuth links https://github.com/supabase/supabase/issues/241#issuecomment-705632335 
- [x] Add docs on Policies

## Additional context

Related PR on `supabase-js` https://github.com/supabase/supabase-js/pull/50

* Updates the docs for the new Auth DX.

* docs: adds docs for subscribing to rows

* Updates all the reads

* Updates all the docs with the new format

* docs: Replaces all { error, data} with data first, because I subjectively think it looks better

* Adds some of the breaking changes to a blog post

* Adds headings

* removes the blog post since it is now in notion

* Adds the Oauth changes

* removes recharts because we no longer use it

* Adds basic structure for GoTrue ref

* Adds styles for the api reference docs

* Adds more generated docs

* Downloads the files to work locally

* Adds a supabase generator

* Moves some of the guides into the "tools" folder

* Re-shuffles some of the pages around

* Generated everythign related to the Supabase Client

* Refactors and categorieses the pages

* Changes the names to be more readable

* Migrates almost all of the filters into the API reference

* Moves most of the stored procedure filters

* Adds realtime-js to the mix

* More desciptive titles

* Moves all the generated docs to the docs folder

* Moves over some of the data manipulators

* Extracts most of the client functionality to the API ref

* Adds more detail to the guides

* Removes the reference to the emulator

* Adds the supabase 1.0 blog post

* Adds a redirects for netlify

* chore: Updates packages

* Updates broken links

* Adding docs for the server

* Adds comments to gotrue and pgapi

* Adds a twitter icon to our navbar

* Updates the auth with the new user and session return values

* Updates the sponsors

* Styles for cards

* Adds a default value to all of the Tabs
2020-11-02 11:08:02 +08:00

1.8 KiB

id, title, description
id title description
aws AWS Host your own Realtime server

Quick Install

You can use our AMI which is registered in the AWS Marketplace under the name Supabase Realtime.

Once the instance is up and running, you first need to point Realtime to listen to your PostgreSQL database. First, SSH to the instance, and edit /etc/realtime/realtime.env:

sudo nano /etc/realtime/realtime.env

You'll see some environment variables you need to set. If you use our Supabase Postgres AMI, you simply need to set DB_HOST to the Postgres instance's public IP, DB_PASSWORD to the password you set with \password postgres, and SECRET_KEY_BASE to a randomly generated secret which you can get by running the command below:

openssl rand -base64 48

Now you need the Realtime service to use the newly set environment variables:

sudo systemctl daemon-reload && sudo systemctl restart realtime

You can now disconnect from SSH. Now you should be able to visit your Realtime endpoint at http://your_realtime_ip:4000 and receive the greeting page, which means you're ready to subscribe to changes to your database with Realtime!

Build from Scratch

Make sure you have Packer installed.

Set your AWS security credentials (you can create these here):

export AWS_ACCESS_KEY=youraccesskey
export AWS_SECRET_KEY=yoursecretkey

Run Packer on aws.json:

packer build aws.json

Launch an instance from the image created by Packer, and follow the steps in Quick Install.