# cli-webui container

The `archivst/cli-webui` Docker image wraps the CLI in a browser WebUI, which is convenient for agent-driven setups on machines where a full browser login is impractical: sign in once (account or auth key), then drive backups, restores, and logs from the page.

## Setup

1. Install Docker and confirm it is running: `docker --version`.
2. Generate a long-lived auth key from your Archivst account if you do not want to do the interactive sign-in inside the WebUI.
3. Pull the image: `docker pull archivst/cli-webui` (pulling again is the update mechanism).
4. Run it, publishing the WebUI port and mounting the folders you want to back up:

   ```bash
   docker run -d --name archivst -p 8080:8080 \
	 -v /path/to/Photos:/Photos \
	 -v /path/to/dest:/restore \
	 archivst/cli-webui
   ```

5. Open `http://localhost:8080`, sign in (or enter the auth key), and start operations.

Only folder paths reachable from inside the container can be backed up or restored, so mount source and destination directories with `-v`. Follow live activity with `docker logs -f archivst`.

Full details, including update and stop instructions, are on the [Docker CLI manual](/manual/archivstcliwebui).

[Back to Agentic Usage](/agentic)