RollDev Usage

Common Commands

Create a new Magento 2 project (automated setup):

roll magento2-init myproject 2.4.7

Launch a shell session within the project environment’s php-fpm container:

roll shell

For use with alternative shells, see the Alternative Shells page

Stopping a running environment:

roll env stop

Starting a stopped environment:

roll env start

Import a database (if you don’t have pv installed, use cat instead):

pv /path/to/dump.sql.gz | gunzip -c | roll db import

Monitor database processlist:

watch -n 3 "roll db connect -A -e 'show processlist'"

Tail environment nginx and php logs:

roll env logs --tail 0 -f nginx php-fpm php-debug

Tail the varnish activity log:

roll env exec -T varnish varnishlog

Flush varnish:

 roll env exec -T varnish varnishadm 'ban req.url ~ .'

Connect to redis:

roll redis

Flush redis completely:

roll redis flushall

Run redis continuous stat mode

roll redis --stat

Remove volumes completely:

roll env down -v

Duplicate the current environment to create a new environment with a different name:

roll duplicate new-environment-name

Create an encrypted duplicate:

roll duplicate staging-env --encrypt

Preview what would be duplicated without executing:

roll duplicate test-env --dry-run

For detailed duplication documentation, see the Environment Duplication page.

Create a backup of all enabled services:

roll backup

Create a backup of specific services:

roll backup db
roll backup redis

List available backups:

roll backup list

Show backup information:

roll backup info 1672531200

Restore the latest backup:

roll restore

Restore a specific backup:

roll restore 1672531200

Preview what would be restored:

roll restore --dry-run

For detailed backup and restore documentation, see the Backup and Restore page.

Run roll help and roll env -h for more details and useful command information.