Skip to content

From the command line

About this page

This documents a stack generated from soliplex-template. A generated project ships its own copy of this page without this note.

The provisioner also runs from the command line, in a one-off soliplex-dev container, which carries git and the provisioner (soliplex-provision-room). It needs the stack to be up; with OIDC on, the backend must admit the provisioner (see With OIDC on).

docker compose run --rm --quiet-build soliplex-dev \
    /app/.venv/bin/soliplex-provision-room \
    --claims '{"preferred_username": "alice", "email": "alice@example.com", "name": "Alice Example"}' \
    --name "Q3 Plans"

The room's id is <owner>--<slug>1: the owner comes from the requester's preferred_username claim, the slug from the room's name (q3-plans), or --slug. --description defaults to the name. The soliplex-template skill's provision_room.py runs the same command, taking --username / --email / --display-name as an alternative to --claims.

It exits 0 when the room is live, 1 when steps after its commit remain (each is printed), and 2 on an error.


  1. In general, a room's id is <owner><separator><slug>, where the separator defaults to --. Set PROVISIONER_ROOM_ID_SEPARATOR in the stack's .env to change it, for instance to keep the legacy form (<owner>:<slug>):

    PROVISIONER_ROOM_ID_SEPARATOR=:
    

    See Settings. ↩