matrix-docker-ansible-deploy/docs/importing-sqlite.md

# Importing an existing SQLite database from another installation (optional)

Run this if you'd like to import your database from a previous default installation of Synapse.
(don't forget to import your `media_store` files as well - see [the importing-media-store guide](importing-media-store.md)).

While this playbook always sets up PostgreSQL, by default a Synapse installation would run
using an SQLite database.

If you have such a Synapse setup and wish to migrate it here (and over to PostgreSQL), this command is for you.


## Prerequisites

Before doing the actual import, **you need to upload your SQLite database file to the server** (any path is okay).


## Importing

Run this command (make sure to replace `<server-path-to-homeserver.db>` with a file path on your server):

	ansible-playbook -i inventory/hosts setup.yml --extra-vars='server_path_homeserver_db=<server-path-to-homeserver.db>' --tags=import-sqlite-db

**Notes**:

- `<server-path-to-homeserver.db>` must be a file path to a `homeserver.db` **file on the server** (not on your local machine!).
- if the SQLite database is from an older version of Synapse, the **importing procedure may run migrations on it to bring it up to date**. That is, your SQLite database file may get modified and become unusable with your older Synapse version. Keeping a copy of the original is probably wise.
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00			`# Importing an existing SQLite database from another installation (optional)`

Do not refer to Synapse as "Matrix Synapse" 2019-04-23 07:20:56 +00:00			`Run this if you'd like to import your database from a previous default installation of Synapse.`
Make media-store restore work with server files, not local This is a simplification and a way to make it consistent with how we do Postgres imports (see 6d89319822f4b2ecb), using files coming from the server, not from the local machine. By encouraging people NOT to use local files, we potentially avoid problems such as #34 (Github issue), where people would download `media_store` to their Mac's filesystem and case-sensitivity issues will actually corrupt it. By not encouraging local files usage, it's less likely that people would copy (huge) directories to their local machine like that. 2019-01-01 13:37:57 +00:00			(don't forget to import your `media_store` files as well - see [the importing-media-store guide](importing-media-store.md)).
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00
Do not refer to Synapse as "Matrix Synapse" 2019-04-23 07:20:56 +00:00			`While this playbook always sets up PostgreSQL, by default a Synapse installation would run`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00			`using an SQLite database.`

Do not refer to Synapse as "Matrix Synapse" 2019-04-23 07:20:56 +00:00			`If you have such a Synapse setup and wish to migrate it here (and over to PostgreSQL), this command is for you.`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00

Make SQLite database import work with server files, not local This is a simplification and a way to make it consistent with how we do Postgres imports (see 6d89319822f4b2ecb), using files coming from the server, not from the local machine. 2019-01-01 13:16:13 +00:00			`## Prerequisites`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00
Update documentation 2019-01-01 13:35:33 +00:00			`Before doing the actual import, you need to upload your SQLite database file to the server (any path is okay).`
Make SQLite database import work with server files, not local This is a simplification and a way to make it consistent with how we do Postgres imports (see 6d89319822f4b2ecb), using files coming from the server, not from the local machine. 2019-01-01 13:16:13 +00:00

			`## Importing`

			Run this command (make sure to replace `<server-path-to-homeserver.db>` with a file path on your server):

			`ansible-playbook -i inventory/hosts setup.yml --extra-vars='server_path_homeserver_db=<server-path-to-homeserver.db>' --tags=import-sqlite-db`

Add additional notice to SQLite importing docs 2020-10-07 06:06:59 +00:00			`Notes:`

			- `<server-path-to-homeserver.db>` must be a file path to a `homeserver.db` file on the server (not on your local machine!).
			`- if the SQLite database is from an older version of Synapse, the importing procedure may run migrations on it to bring it up to date. That is, your SQLite database file may get modified and become unusable with your older Synapse version. Keeping a copy of the original is probably wise.`