The kit starts LocalStack in a startup hook. lskit-status shows the state
for the current boot. Read the state and the log from the host:
$ sbx exec ls-claude bash -lc 'lskit-status; tail -n 40 /tmp/localstack-kit/start.log'| State | Meaning |
|---|---|
starting |
lstk is pulling the image or starting the container. The first pull takes some minutes. |
running |
LocalStack is ready. |
missing-token |
The sandbox has no LOCALSTACK_AUTH_TOKEN. Create the sandbox again with -e LOCALSTACK_AUTH_TOKEN. |
config-missing |
LSKIT_LSTK_CONFIG names a file that does not exist. The path is absolute or relative to the workspace. |
config-rejected |
The project config starts an image that is not a LocalStack image. See Security. |
docker-unavailable |
Docker in the sandbox did not start in 180 seconds. |
failed |
lstk start failed. Read the log. |
To start LocalStack again, run lstk start in the sandbox.
cannot be installed — its source is not in your allowlist
sbx loads kits from docker.io/ only by default. The published kits are on
Docker Hub. If you use another registry, add its prefix:
$ sbx settings set kit.allowedSources '["docker.io/","registry.example.com/localstack/"]'License validation failed ... invalid, inactive, or expired authentication token
Make sure that LOCALSTACK_AUTH_TOKEN holds the token itself. On macOS, the
keychain entry of lstk login holds an encoded value
(go-keyring-base64:...), not the token. To decode it:
$ security find-generic-password -s lstk -a lstk.auth-token -w \
| sed 's/^go-keyring-base64://' | base64 -dLocalStack fails at start with this error when its image files contain
zeros. This occurs when the host disk is full while the sandbox pulls the
image: the sandbox disk grows on the host, and the writes fail. The sandbox
log then shows I/O error, dev vdd.
-
Make free space on the host disk.
-
Remove the damaged image in the sandbox and start again:
$ sbx exec ls-claude bash -c 'docker rm -f $(docker ps -aq --filter name=localstack); docker rmi $(docker images -q "localstack/*"); lstk start'
sbx 0.45 stops a local sandbox 30 seconds after the last session ends.
LocalStack starts again with no resources on the next session. Save a
snapshot before you leave, and load it when you come back:
$ lstk snapshot save ./localstack.snapshot
$ lstk snapshot load ./localstack.snapshotstart does not support AWS_ENDPOINT_URL
lstk reads AWS_ENDPOINT_URL as an instruction to use a remote emulator. The
lstk command of the kit (/opt/localstack-kit/bin/lstk) removes the
variable before it runs lstk. This error occurs only if you run the lstk
binary directly.
sbx -p reaches only ports that listen on all interfaces in the sandbox. The
kit config binds LocalStack to all interfaces. A project config
(.lstk/config.toml or LSKIT_LSTK_CONFIG) binds it to loopback, unless it
sets GATEWAY_LISTEN. The start log then has a note. Add this line to the
env profile of the project config, and run lstk restart:
GATEWAY_LISTEN = "0.0.0.0:4566,0.0.0.0:443"If LocalStack also runs on your host, -p 4566:4566 cannot publish the
port. Use a different host port, for example -p 4567:4566. In the sandbox,
LocalStack stays on port 4566.
no binding authorizes anthropic — the credential was not injected
These kits are third-party kits for sbx, so you must approve the agent
credential one time. sbx asks for approval only in an interactive
terminal. Run the kit one time with sbx run in a terminal. After that,
unattended runs such as sbx create or sbx run -d use the approval.
Under the balanced or deny-all policy, run sbx policy log to see which
host was blocked and by which rule. Add a rule for one sandbox:
$ sbx policy allow network --sandbox ls-claude example.com:443OCI exporter is not supported for the docker driver
sbx run --kit ./kits/localstack builds the kit with your default Docker
Buildx builder. The docker driver without the containerd image store
(for example on OrbStack) cannot export OCI images. Use a
docker-container builder:
$ docker buildx create --name lskit --driver docker-container --bootstrap
$ BUILDX_BUILDER=lskit sbx run -e LOCALSTACK_AUTH_TOKEN \
docker.io/docker/sbx-kit-claude:2.1.278 --kit ./kits/localstack .