# Upgrading an EventStore

The [CHANGELOG](https://github.com/commanded/eventstore/blob/master/CHANGELOG.md) is used to indicate when a schema migration is required for a given version of the EventStore.

You can upgrade an existing EventStore database using the following mix task:

```console
$ mix event_store.migrate
```

Or use `mix event_store.migrate -e MyApp.EventStore` to specify an event store as an argument.

Run this command each time you upgrade; it is safe to run multiple times.

You must stop your application to apply an upgrade. It is *always* worth taking a full backup of the EventStore database before applying an upgrade.

Creating an EventStore, using the `mix event_store.create` task, will always use the latest database schema.
