Docker

Syncmaven is available as a Docker image - syncmaven.

Create a project directory

mkdir ./syncmaven-example

Initialize the project

docker run --rm -v ./syncmaven-example:/project syncmaven/syncmaven init

syncmaven/syncmaven docker image assumes that the project lives in docker image /project directory. It should be mounted to the local host directory where the project is located.

Edit the project

Edit the project files in the ./syncmaven-example.

Run all syncs

docker run --rm -v ./syncmaven-example:/project syncmaven/syncmaven sync

Explore other commands by running docker run --rm syncmaven --help.

NPM

Syncmaven is also available as an NPM package - syncmaven. It can be installed locally and used as a CLI tool. Make sure you have Node.js installed on your machine and it’s version is 20 or higher.

Syncmaven NPM package is not stable yet. You may face issues during installation. If you do, please use the Docker image.

npm install -g syncmaven

Then you can use syncmaven command to run the tool.

syncmaven init -d ./syncmaven-example # Initialize the project
syncmaven sync -d ./syncmaven-example # Run all syncs
syncmaven help # Explore other commands

Next steps

Get yourself familiar with the fundamentals:

Project

How to create a project and its structure

Model

How to define a model, an SQL query that tells Syncmaven how to fetch data

Destination

How to define a destination, a place where the data will be synced

Sync

A process that connects a model with a destination

Get Started

Fundamentals

Quickstart

Docker

NPM

Next steps

Project

Model

Destination

Sync

​Docker

​NPM

​Next steps

Project

Model

Destination

Sync

Docker

NPM

Next steps