Skip to main content

PILOS CLI

PILOS-CLI is a command line tool to interact with the PILOS application. It has a few special commands, but the majority of the commands are passed through to the Laravel artisan command.

Command list

up / down

Activate or deactivate the maintenance mode of the application.

docker compose exec app pilos-cli up
docker compose exec app pilos-cli down

frontend:build

(Re-)build the PILOS frontend within the running container. Is automatically executed when the container is started. Can be used to rebuild the frontend after changes to the frontend code.

docker compose exec app pilos-cli frontend:build

playback-player:build

Build the BigBlueButton recording player with the release version you want.

docker compose exec app pilos-cli playback-player:build 5.0.2

See Recording for more information.

locales:cache

Caches all locales in the application. Automatically executed when the container is started.

docker compose exec app pilos-cli db:check

users:create:superuser

Creates a new superuser account.

docker compose exec app pilos-cli db:check

db:check

Test the connection to the database.

docker compose exec app pilos-cli db:check

db:migrate

Run the database migrations, should always be executed with the --seed flag to rerun the seeders. Rerunning the seeders will not overwrite existing data, but adds new data (e.g. new permissions).

docker compose exec app pilos-cli migrate --seed

db:import

Import database dump from a file inside the container.

To restore a database dump, you can use the following commands to copy the dump into the container, clear the current database and import the dump.

The db:import command executes the mysql or postgresql by passing the database credentials from the .env file as arguments. Use with special care: This is considered unsafe as the password may be visible in the process list or logs files.

docker compose cp ./db_backup.sql app:/var/www/html/db_backup.sql`
docker compose exec app pilos-cli db:wipe --force
docker compose exec app pilos-cli db:import /path/to/dump.sql

A more secure way is to use the docker-compose exec command to execute the mysql or psql command directly.

docker compose cp ./db_backup.sql app:/var/www/html/db_backup.sql`
docker compose exec app pilos-cli db:wipe --force
docker compose exec app mysql

Using this method you can also export the database with the mysqldump or pg_dump commands.

More commands

To list all available artisan commands, you can run the following command:

docker compose exec app pilos-cli list