Skip to content
Mehrdad Pajuhaan edited this page Oct 23, 2026 · 1 revision

FAQ

Direct answers to common questions about Clone Sheet, including troubleshooting.

Which databases are supported?

MariaDB and MySQL, local or remote. The app connects with the Sequelize mariadb dialect and the setup wizard uses mysql2 to create the database.

Does Clone Sheet change anything in my shop?

No. The token it asks for has only read scopes, and Clone Sheet only reads from the Selldone API. All writes go to your local database.

The setup page says "Connection failed".

Check that the database server is running and that host, port, username and password are correct. The wizard connects without selecting a database first, so the user needs permission to create the database if it does not exist yet. Fix the values in the form and submit again.

npm start cannot connect to the database.

npm start uses the values in .env. The .env in the repository is an example (DB_PORT=4000, DB_NAME=test). Run node setup.js once, or edit .env to match your server. See Setup and Configuration.

Which port does the app use?

The wizard starts the app on the Application Port (default 3010) or the next free port. npm start uses PORT from .env, or 3000 if it is not set. The setup wizard itself runs on port 3000 or the next free port.

Sync says "Token or shop ID is missing."

Connect first: in the Setup tab paste the token and shop ID and click Save & Connect. See Syncing Data.

Save & Connect fails with "Authentication failed. Check your token."

The token is invalid, expired or revoked, or it was created for another shop. Create a new token with Create Access Token and connect again. If a sync stops with an error later, the same check applies; the Sync tab shows the error message for each resource. Manage tokens at selldone.com/developer/access.

Why did my data disappear after connecting another shop?

Clone Sheet keeps one shop at a time. Connecting a different shop ID clears the synced tables and sync times first. Use a separate database (run the wizard with another database name in another copy of the project) to keep several shops.

How do I force a full re-sync?

Open the Database tab and click Clear All Data, then run Sync All Resources. Without sync times, every record is downloaded again.

Can I run syncs on a schedule?

Yes. While the app is running, call the sync endpoints, for example curl -X POST http://localhost:3010/products/fetch-products, from cron or another scheduler. The full list is in Syncing Data.

NocoDB cannot reach my database.

Inside Docker, localhost is the container itself. Use host.docker.internal as the host and your database port (default 3306).

Is it safe to expose Clone Sheet on a server?

The app has no login of its own and its endpoints are not authenticated, and the access token is stored in the key_values table. Run it on a trusted machine and do not expose its port to the internet.

Related