6e1dfb62f0
Since we'll likely have generic SQLite database importing via [pgloader](https://pgloader.io/) for migrating bridge databases from SQLite to Postgres, we'd rather avoid calling the "import Synapse SQLite database" command as just `--tags=import-sqlite-db`. Similarly, for the media store, we'd like to mention that it's related to Synapse as well. We'd like to be more explicit, so as to be less confusing, especially in light of other homeserver implementations coming in the future.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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
|
|
```
|
|
|
|
**Note**: if you don't use SSH keys for authentication, but rather a regular password, you may need to add `--ask-pass` to the above (and all other) Ansible commands.
|
|
|
|
**Note**: if you **do** use SSH keys for authentication, **and** use a non-root user to *become* root (sudo), you may need to add `-K` (`--ask-become-pass`) to the above (and all other) Ansible commands.
|
|
|
|
The above command **doesn't start any services just yet** (another step does this later - below).
|
|
|
|
Feel free to **re-run this setup command 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 Synapse installation)](importing-synapse-sqlite.md) (optional)
|
|
|
|
- [Importing an existing Postgres database (from another installation)](importing-postgres.md) (optional)
|
|
|
|
- [Importing `media_store` data files from an existing Synapse installation](importing-synapse-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)
|
|
- or learn how to [migrate to another server](maintenance-migrating.md)
|