Skip to main content

Docs

The docs command starts the Palette documentation site in your local environment for an offline experience. A container image with the latest documentation content is downloaded and a local Caddy server is started to serve the documentation site. You can access the Palette documentation site at http://localhost:8080 using your browser.

tip

To stop the documentation site, type Ctrl+C in the terminal window where you started it.

The docs command exposes the following flags.

Short FlagLong FlagDescriptionType
-d--detachStart the container in the background and print the container ID.boolean
-h--helpHelp with any command.N/A
--hostThe address of the host to expose the container on. The default value is set to 127.0.0.1string
--imageThe documentation container image to use. Default value is ghcr.io/spectrocloud/librarium:nightly.string
--nameThe name of the container. Default value is spectrocloud-docs.string
--portThe port to expose the container on. The default value is set to 8080.string

Examples

Start the documentation site in the background.

palette docs --detach
{"status":"Pulling from spectrocloud/librarium","id":"nightly"}
{"status":"Digest: sha256:754a75fe5b2724ad7fdd42389432fa8f81c2362880c236dabaa29ef6963b7ac6"}
{"status":"Status: Image is up to date for ghcr.io/spectrocloud/librarium:nightly"}
Started ghcr.io/spectrocloud/librarium:nightly at 127.0.0.1:8080
d7c8190bb73f4e96b5275fd0d7e1f27a06b784c881ec9437a233ac0a3a8ca979

Start the documentation site in the background and expose it on port 9000.

palette docs --detach --port 9000
{"status":"Pulling from spectrocloud/librarium","id":"nightly"}
{"status":"Digest: sha256:754a75fe5b2724ad7fdd42389432fa8f81c2362880c236dabaa29ef6963b7ac6"}
{"status":"Status: Image is up to date for ghcr.io/spectrocloud/librarium:nightly"}
Started ghcr.io/spectrocloud/librarium:nightly at 127.0.0.1:9000
cd9b79f7947b317c76d9517cc5c09ad6e12e7606c08ce24b497e07c7af6775c3

Start the documentation site in the background and change the container name.

palette docs --detach --name palette-offline
{"status":"Pulling from spectrocloud/librarium","id":"nightly"}
{"status":"Digest: sha256:754a75fe5b2724ad7fdd42389432fa8f81c2362880c236dabaa29ef6963b7ac6"}
{"status":"Status: Image is up to date for ghcr.io/spectrocloud/librarium:nightly"}
Started ghcr.io/spectrocloud/librarium:nightly at 127.0.0.1:8080
94928fc8b2dd9118fe66c72dd7e977f1075f85e234a131832f43537d91e27bc3

Start the documentation site in the background and change container image to a self-hosted registry. Check put the Offline Documentation to learn how to extract the container image into a tarball which you can then load into another device and upload to a self-hosted registry.

palette docs --detach --name palette-offline --image internal.example.org/spectrocloud/librarium:nightly
{"status":"Pulling from spectrocloud/librarium","id":"nightly"}
{"status":"Digest: sha256:754a75fe5b2724ad7fdd42389432fa8f81c2362880c236dabaa29ef6963b7ac6"}
{"status":"Status: Image is up to date for internal.example.org/spectrocloud/librarium:nightly"}
Started internal.example.org/spectrocloud/librarium:nightly at 127.0.0.1:8080
94928fc8b2dd9118fe66c72dd7e977f1075f85e234a131832f43537d91e27bc3