matrix-docker-ansible-deploy/docs/installing.md

# Installing

If you've [configured your DNS](configuring-dns.md) and have [configured the playbook](configuring-playbook.md), you can start the installation procedure.

Run this as-is to set up a server:

```bash
ansible-playbook -i inventory/hosts setup.yml --tags=setup-all
```

This **doesn't start any services just yet** (another step does this later - below).

Feel free to **re-run this any time** you think something is off with the server configuration.


## Things you might want to do after installing

After installing, but before starting the services, you may want to do additional things like:

- [Importing an existing SQLite database (from another installation)](importing-sqlite.md) (optional)

- [Importing an existing Postgres database (from another installation)](importing-postgres.md) (optional)

- [Importing `media_store` data files from an existing installation](importing-media-store.md) (optional)


## Starting the services

When you're ready to start the Matrix services (and set them up to auto-start in the future):

```bash
ansible-playbook -i inventory/hosts setup.yml --tags=start
```

Now that the services are running, you might want to:

- **finalize the installation process** (required for federation to work!) by [Configuring Service Discovery via .well-known](configuring-well-known.md)
- or [create your first user account](registering-users.md)
- or [set up the Dimension Integrations Manager](configuring-playbook-dimension.md)
- or [check if services work](maintenance-checking-services.md)
- or learn how to [upgrade your services when new versions are released](maintenance-upgrading-services.md)
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00			`# Installing`

Update installing.md 2018-09-08 21:23:34 +00:00			`If you've [configured your DNS](configuring-dns.md) and have [configured the playbook](configuring-playbook.md), you can start the installation procedure.`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00
			`Run this as-is to set up a server:`

			```bash
			`ansible-playbook -i inventory/hosts setup.yml --tags=setup-all`
			```

			`This doesn't start any services just yet (another step does this later - below).`

			`Feel free to re-run this any time you think something is off with the server configuration.`


Add Service Discovery (/.well-known/matrix/client) support 2018-09-17 07:51:46 +00:00			`## Things you might want to do after installing`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00
			`After installing, but before starting the services, you may want to do additional things like:`

			`- [Importing an existing SQLite database (from another installation)](importing-sqlite.md) (optional)`

Add support for importing an existing Postgres database 2019-01-01 12:40:48 +00:00			`- [Importing an existing Postgres database (from another installation)](importing-postgres.md) (optional)`

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			- [Importing `media_store` data files from an existing installation](importing-media-store.md) (optional)
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00

Add Service Discovery (/.well-known/matrix/client) support 2018-09-17 07:51:46 +00:00			`## Starting the services`
Split README into a bunch of files in docs/ 2018-08-08 07:07:02 +00:00
			`When you're ready to start the Matrix services (and set them up to auto-start in the future):`

			```bash
			`ansible-playbook -i inventory/hosts setup.yml --tags=start`
			```

Add Service Discovery (/.well-known/matrix/client) support 2018-09-17 07:51:46 +00:00			`Now that the services are running, you might want to:`

Initial work on Synapse 0.99/1.0 preparation 2019-02-05 09:07:08 +00:00			`- finalize the installation process (required for federation to work!) by [Configuring Service Discovery via .well-known](configuring-well-known.md)`
			`- or [create your first user account](registering-users.md)`
Make some additions to Dimension documentation 2019-03-10 11:17:56 +00:00			`- or [set up the Dimension Integrations Manager](configuring-playbook-dimension.md)`
Initial work on Synapse 0.99/1.0 preparation 2019-02-05 09:07:08 +00:00			`- or [check if services work](maintenance-checking-services.md)`
Link to Synapse Homeowners room 2018-12-11 16:15:09 +00:00			`- or learn how to [upgrade your services when new versions are released](maintenance-upgrading-services.md)`