This page only applies to Datomic 781-9041 and lower.
This page walks your through configuring Client API connectivity to a Datomic system from outside the Datomic VPC. This takes two steps:
The latest Datomic Cloud setup process does not require these steps.
This page assumes that an administrator has already:
Before you configure Client API connectivity to a Datomic database from outside the VPC, you need to:
- Install Clojure 1.9 or later.
- Install the AWS CLI version 1.11.170 or greater.
- Install the Datomic CLI Tools
- Configure a shell environment with AWS access keys for Datomic
- Know the region and name of the Datomic System you want to connect to
Connect to the Access Gateway
To connect to the access gateway, run the datomic access command to create an SOCKS proxy connection, passing your system name:
datomic client access <system>
The script will continue to run once launched.
Test Access Gateway Connection
Run the following command to test your system's ability to reach
Datomic through the SOCKS proxy, replacing
[port] with your system-name, region and port.
curl -x socks5h://localhost:8182 http://entry.[system].[region].datomic.net:8182/
On success, this command will return text like:
Any other response indicates a failure to connect. Carefully review the prerequisites and steps on this page. If you feel that you have completed each step correctly, see the troubleshooting documentation.
If you are trying Datomic for the first time, a good next step is the Client API Tutorial.