{"id":14973911,"url":"https://github.com/swarm64/s64da-compose","last_synced_at":"2025-04-26T23:31:42.414Z","repository":{"id":56469906,"uuid":"192314321","full_name":"swarm64/s64da-compose","owner":"swarm64","description":"Swarm64 DA Docker Compose","archived":false,"fork":false,"pushed_at":"2020-11-27T15:46:39.000Z","size":50,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T18:22:52.452Z","etag":null,"topics":["postgresql","psql"],"latest_commit_sha":null,"homepage":"https://swarm64.com/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/swarm64.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-17T09:15:45.000Z","updated_at":"2020-11-27T15:39:25.000Z","dependencies_parsed_at":"2022-08-15T19:20:38.015Z","dependency_job_id":null,"html_url":"https://github.com/swarm64/s64da-compose","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarm64%2Fs64da-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarm64%2Fs64da-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarm64%2Fs64da-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarm64%2Fs64da-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swarm64","download_url":"https://codeload.github.com/swarm64/s64da-compose/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251068038,"owners_count":21531475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["postgresql","psql"],"created_at":"2024-09-24T13:49:40.302Z","updated_at":"2025-04-26T23:31:42.168Z","avatar_url":"https://github.com/swarm64.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Summary\n\nSwarm64 DA Docker Compose will assist in starting an instance of S64 DA or native PSQL.\nOnce the instance is up and running you can connect through a psql client or run\na benchmark using the [Swarm64 DA Benchmark Toolkit](https://github.com/swarm64/s64da-benchmark-toolkit).\n\nImportant notice: In order to guarantee compatibility between S64 DA and\ns64da-compose, please checkout the GIT Tag that corresponds to your version of S64 DA.\nFor example, if your version of S64 DA is 5.1.0, clone this repository and run\n`git checkout v5.1.0` within the the repository root folder before proceeding.\n\n# Prerequisites\n\n- Python 3.6 or higher\n- docker-compose 1.26 or higher (eg. use: python3 -m pip install docker-compose)\n\n# Start an instance or multiple instances\n\n1. Before starting an instance, review the `.env` file and apply necessary\n   changes as noted in the file itself. In particular, pay attention the the\n   Swarm64 DA version and the data directories. If you want to run both\n   databases at the same time, the ports they listen on must differ.\n\n2. Copy your S64 DA license file into the `license` directory and rename it\n   to `s64da.license`, replacing the existing dummy license file. If you don't\n   have a license file yet request one by contacting support@swarm64.com.\n\n3. (Optional) Apply any PG configuration changes to `configs/pg.env` and/or\n   `configs/s64da.env`. Each setting must be prefixed with `pgconf_` in order\n   to be picked up. Changing a value with an existing data directory will cause\n   the config keys to be updated. The suffix following `pgconf_` before `=`\n   must match a key in postgresql.conf. If you have to put a config key with a\n   dot replace the `.` with `__`. For instance, `a.b=c` becomes:\n   `pgconf_a__b=c`.\n\n   The provided default configuration is suitable for running benchmarks up to\n   1 TiB worth of data on a system with 384 GiB of memory.\n\n4. To start a database instance, call `docker-compose` accordingly:\n\n   - S64 DA CPU accelerated: `docker-compose -f docker-compose-base.yml -f docker-compose-s64da-cpu.yml up`\n   - Native PostgreSQL: `docker-compose -f docker-compose-base.yml -f docker-compose-psql.yml up`\n\n6. Connect to the instance: `psql -h localhost -U postgres` (optional: -p {PORT} if other than 5432)\n\n7. Ingest data or run a benchmark for example with the [Swarm64 DA Benchmark Toolkit](https://github.com/swarm64/s64da-benchmark-toolkit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarm64%2Fs64da-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswarm64%2Fs64da-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarm64%2Fs64da-compose/lists"}