Enter the details above to the web app at app.usebracket.com
In the case that your postgres database is not accessible to the public, bracket can
connect to your database through a bastion host/jump box, using SSH tunneling to
connect. Follow these steps to ensure a successful connection:
Click on the “Create SSH tunnel” button on the postgres connection details page,
after you’ve entered the primary details for your postgres.
Enter in the jump box and destination host connection details.
You will then be provided with an ed25519 key pair. You can either copy the text or
download the key. Keep in mind that this key is unique to this connection and will not be
shown again. Once you’ve saved this information, you can close the modal window by clicking
“Done”.
Enter that public key to your ~/.ssh/authorized_keys file in your jump box. We recommend
adding a comment like “bracket” after the key to keep your keys organized.
After saving the ~/.ssh/authorized_keys file with the , click “Next” on the bracket
postgres connection details and bracket will notify you if the connection was successful!
For Bracket to be able to be able to generate Postgres tables from other primary sources, we require the following permissions, which can be assigned via SQL.
Database-level permissions
GRANT CONNECT, CREATE ON DATABASE [your_database] TO [bracket_username];
Schema-level permissions
GRANT USAGE, CREATE, ALTER, REFERENCES ON SCHEMA [your_schema] TO [bracket_username];
For Bracket to be able to sync with an existing Postgres table, we require the following permissions:
Schema-level permissions
GRANT SELECT, INSERT, UPDATE, DELETE, REFERENCES, TRIGGER ON [your_table] TO [bracket_username];
Optional: Creating a read only user on your database
Perform this step if you would like to give Bracket access through a dedicated account. Skip this step if you prefer to use an existing Postgres account during setup.
Create a new user and password
Postgres User Creation
CREATE USER bracket WITH PASSWORD 'any_safe_password';
Allow this new user to connect to the database
Postgres Connection Access
GRANT CONNECT ON DATABASE database_name TO bracket;