Files
medusa-store/docs/content/troubleshooting/transaction-error-in-checkout.md
Shahed Nasser 1cc4f9ac2d docs: improve troubleshooting (#1739)
* docs: improve troubleshooting

* fixes
2022-06-27 16:57:24 +03:00

60 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Error 409 in checkout
To provide the most frictionless onboarding and quickstart, Medusa uses SQLite as the server's database by default. SQLite runs on all machines and operating systems. So, it allows you to get quickly started without installing PostgreSQL.
However, this comes at the expense of important features that are needed in a production environment.
Therefore, you might experience the following error when going through a checkout flow in one of Medusa's starters while using SQLite:
```bash
Error: Transaction already started for the given connection, commit current transaction before starting a new one.
```
This error occurs because SQLite does not allow for multiple write transactions at the same time. To resolve it, you need to use PostgreSQL instead.
You can learn how to install PostgreSQL on your machine in the [Set Up your Development Environment documentation](../tutorial/0-set-up-your-development-environment.mdx#postgresql).
Then in your `medusa-config.js`, you should change the project configuration to use Postgres as the database type:
```jsx
module.exports = {
projectConfig: {
//...
database_url: DATABASE_URL,
database_type: "postgres",
},
plugins,
}
```
Where `DATABASE_URL` is the connection string to your PostgreSQL database. You can check out how to format it in [PostgreSQLs documentation](https://www.postgresql.org/docs/current/libpq-connect.html).
Make sure to also remove the following lines that are used to configure an SQLite database:
```jsx
database_type: "sqlite",
database_database: "./medusa-db.sql",
```
Then, migrate the database schema to the new PostgreSQL database:
```bash
medusa migrations run
```
:::tip
If you want to add demo data into your server, you should also seed the database using the following command:
```bash npm2yarn
npm run seed
```
:::
## Additional Resources
- Learn how to [set up your development environment](../tutorial/0-set-up-your-development-environment.mdx).
- Learn how to [configure your server](../usage/configurations.md).
- Learn more about [the Medusa CLI tool](../cli/reference.md).