Runs the pending migrations for the given repository.

The repository must be set under :ecto_repos in the current app configuration or given via the -r option.

By default, migrations are expected at “priv/YOUR_REPO/migrations” directory of the current application but it can be configured to be any subdirectory of priv by specifying the :priv key under the repository configuration.

Runs all pending migrations by default. To migrate up to a version number, supply --to version_number. To migrate up a specific number of times, use --step n.

If the repository has not been started yet, one will be started outside our application supervision tree and shutdown afterwards.

Examples

mix ecto.migrate
mix ecto.migrate -r Custom.Repo

mix ecto.migrate -n 3
mix ecto.migrate --step 3

mix ecto.migrate -v 20080906120000
mix ecto.migrate --to 20080906120000

Command line options

• -r, --repo - the repo to migrate
• --all - run all pending migrations
• --step / -n - run n number of pending migrations
• --to / -v - run all migrations up to and including version
• --quiet - do not log migration commands
• --prefix - the prefix to run migrations on
• --pool-size - the pool size if the repository is started only for the task (defaults to 1)