Check sqlrs --help from the installed archive if a command differs from this page. :::
mkdir sqlrs-demo
cd sqlrs-demo
sqlrs init local --snapshot auto
sqlrs status
The status output should report that the local engine and container runtime are ready. A copy-based
snapshot backend is expected when Btrfs is unavailable.
sqlrs prepare:psql --image postgres:16 -- -c "create table if not exists smoke_check(id int); insert into smoke_check values (1);" run:psql -- -t -A -c "select count(*) from smoke_check;"
This composite has two stages. The prepare stage creates an immutable state from the explicit image
and SQL statement. The run stage starts an instance from that state and queries it. A successful run
prints 1.
Arguments after -- belong to psql; sqlrs supplies the connection and rejects conflicting
connection arguments. Once the inline smoke test works, the aliases guide shows
how to move real project commands into repository-tracked recipes.