doc: add sandbox with codapi-cli

Author: nalgeon

README.md

@@ -30,9 +30,8 @@ To run Codapi locally, follow these steps:
 
 ```sh
 mkdir ~/codapi && cd ~/codapi
-curl -L -o codapi.tar.gz "https://github.com/nalgeon/codapi/releases/download/v0.10.0/codapi_0.10.0_linux_amd64.tar.gz"
+curl -L -o codapi.tar.gz "https://github.com/nalgeon/codapi/releases/download/v0.11.0/codapi_0.11.0_linux_amd64.tar.gz"
 tar xvzf codapi.tar.gz
-chmod +x codapi
 rm -f codapi.tar.gz
 ```
 
@@ -48,20 +47,22 @@ docker build --file sandboxes/ash/Dockerfile --tag codapi/ash:latest sandboxes/a
 ./codapi
 ```
 
-Running in production is a bit more involved. See these guides:
-
--   [Installing Codapi](docs/install.md)
--   [Updating Codapi](docs/update.md)
--   [Deploying to production](docs/production.md)
-
 ## Usage
 
-See [Adding a sandbox](docs/add-sandbox.md) to create a custom sandbox.
+See [Adding a sandbox](docs/add-sandbox.md) to add a sandbox from the [registry](https://github.com/nalgeon/sandboxes) or create a custom one.
 
 See [API](docs/api.md) to run sandboxed code using the HTTP API.
 
 See [codapi-js](https://github.com/nalgeon/codapi-js) to embed the JavaScript widget into a web page.
 
+## Production
+
+Running in production is a bit more involved. See these guides:
+
+-   [Installing Codapi](docs/install.md)
+-   [Updating Codapi](docs/update.md)
+-   [Deploying to production](docs/production.md)
+
 ## Contributing
 
 Contributions are welcome. For anything other than bugfixes, please first open an issue to discuss what you want to change.

docs/add-sandbox.md

@@ -4,7 +4,27 @@ A _sandbox_ is an isolated execution environment for running code snippets. A sa
 
 Codapi comes with a single `ash` sandbox preinstalled, but you can easily add others. Let's see some examples.
 
-## Python
+## Add a sandbox from the registry
+
+The [sandboxes](https://github.com/nalgeon/sandboxes) repository contains several dozen ready-to-use sandboxes, from Go and Rust, to PostgreSQL and ClickHouse, to Caddy and Ripgrep.
+
+To add a sandbox, use `codapi-cli` like this:
+
+```text
+./codapi-cli sandbox add <name>
+```
+
+For example:
+
+```sh
+./codapi-cli sandbox add lua
+./codapi-cli sandbox add go
+./codapi-cli sandbox add mariadb
+```
+
+Then restart the Codapi server and you're done.
+
+## Create a sandbox from scratch
 
 First, let's create a Docker image capable of running Python with some third-party packages:
 

docs/install.md

@@ -28,9 +28,8 @@ docker run hello-world
 
 ```sh
 cd /opt/codapi
-curl -L -o codapi.tar.gz "https://github.com/nalgeon/codapi/releases/download/v0.10.0/codapi_0.10.0_linux_amd64.tar.gz"
+curl -L -o codapi.tar.gz "https://github.com/nalgeon/codapi/releases/download/v0.11.0/codapi_0.11.0_linux_amd64.tar.gz"
 tar xvzf codapi.tar.gz
-chmod +x codapi
 rm -f codapi.tar.gz
 ```
 

docs/update.md

@@ -16,7 +16,6 @@ cd /opt/codapi
 export version="0.x.x"
 curl -L -o codapi.tar.gz "https://github.com/nalgeon/codapi/releases/download/${version}/codapi_${version}_linux_amd64.tar.gz"
 tar xvzf codapi.tar.gz
-chmod +x codapi
 rm -f codapi.tar.gz
 ```