Events dump and rebuild

Events Dump & Rebuild Procedure

Dumping Events To File

All events stored in the database may be written to a single regular file. The format is a Matrix-canonical JSON array of Matrix event objects. Issue the following console command to dump events; progress updates will be logged at the INFO level and should be visible by default.

👉 While it is safe to dump events during normal service, we make no guarantee for whether new events processed after the start of the dump will be included. For optimal performance and results, perform the dump in single-user mode by employing the -single program option.

1. events dump <path>

Bootstrapping from Events File

Given a fresh (or non-existent) database, Construct performs an automatic "bootstrap" creating essential internal rooms and events. This "first startup" functionality can be supplanted by an array of events in a regular file instead.

❗ The only supported use of this feature is in conjunction with an Events Dump. The bootstrap vector must contain only valid and trusted events; essential events must not be missing. Do not modify events.

1. After performing an events dump, shutdown the server.

2. Move the events database directory to a backup location. By default, the events database is found at /var/db/construct/<hostname>/events but its exact location may vary on different systems.

3. Start the server with the additional -bootstrap <path> program option; example:

bin/construct -bootstrap <path> <hostname>