2018-08-08 07:07:02 +00:00
# Installing
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.
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.
2018-09-17 07:51:46 +00:00
## Things you might want to do after installing
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)
2019-01-01 12:40:48 +00:00
- [Importing an existing Postgres database (from another installation) ](importing-postgres.md ) (optional)
2019-01-01 13:37:57 +00:00
- [Importing `media_store` data files from an existing installation ](importing-media-store.md ) (optional)
2018-08-08 07:07:02 +00:00
2018-09-17 07:51:46 +00:00
## Starting the services
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
```
2018-09-17 07:51:46 +00:00
Now that the services are running, you might want to:
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 )
2019-03-10 11:17:56 +00:00
- or [set up the Dimension Integrations Manager ](configuring-playbook-dimension.md )
2019-02-05 09:07:08 +00:00
- or [check if services work ](maintenance-checking-services.md )
2018-12-11 16:15:09 +00:00
- or learn how to [upgrade your services when new versions are released ](maintenance-upgrading-services.md )
2019-06-11 20:06:25 +00:00
- or learn how to [migrate to another server ](maintenance-migrating.md )