installing.md

Installing

If you've configured your DNS and have configured the playbook, you can start the installation procedure.

Run this as-is to set up a server:

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 installation) (optional)

• Importing an existing Postgres database (from another installation) (optional)

• Importing media_store data files from an existing installation (optional)

Starting the services

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

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
• or create your first user account
• or set up the Dimension Integrations Manager
• or check if services work
• or learn how to upgrade your services when new versions are released
• or learn how to migrate to another server