This guide provides step-by-step instructions for deploying an Oxla Docker container and integrating it with Amazon S3 Storage as the object storage.
You will configure Docker, create a Docker Compose file and run the Oxla container so it can read from and write to Amazon S3 Storage.
PostgreSQL Client: install PostgreSQL client to connect to the Oxla database
AWS S3 Bucket: create an AWS S3 bucket to store you data
AWS Credentials: obtain your AWS access key ID and secret access key.
For details, see the AWS Identity and Access Management documentation on access keys
Open your terminal and create a new Docker Compose file named docker-compose.s3-credentials.yml:
Copy
Ask AI
vim docker-compose.s3-credentials.yml
Add the following configuration into the file and replace the placeholder values below with the actual credentials and region settings from your AWS instance to enable proper access to S3 resources:
After saving the YAML file, run the following command to create and start the Oxla docker container:
Copy
Ask AI
docker compose -f docker-compose.s3-credentials.yml up
This command will start the Oxla service and connects it to your specified S3 bucket using the provided credentials.
To verify that Oxla is running correctly, connect using the PostgreSQL client:
Copy
Ask AI
psql -h localhost -U oxla oxla
The default username and password for the Oxla superuser are both “oxla”.
Upon successful execution, you should see a similar output:
Copy
Ask AI
psql (17.2 (Ubuntu 17.2-1.pgdg22.04+1), server 16.0 (oxla version: 1.69.0)oxla=>