Skip to main content

Self-hosting Queso

You can easily self-host the Queso backend server using Docker. The server provides a REST API for managing bookmarks and integrates seamlessly with the official Queso Bookmarks browser extension or the local extension build.

Setting Up a Development Environment​

  1. Clone the Queso Bookmarks repository and navigate to the project directory
  2. Run the backend locally using the same steps as the Docker quick start above:
cp ./local-backend/.env.example ./local-backend/.env
echo "API_TOKEN=$(openssl rand -base64 32)" >> ./local-backend/.env
docker-compose up -d --build

The server will be available at http://localhost:8083 once the containers finish starting.

  1. To run the extension locally:
pnpm run build

  1. Load the generated build into Chrome by opening chrome://extensions, enabling Developer Mode, and using Load unpacked to select the build/ directory.

  2. Once your server is running, configure the browser extension to use your self-hosted instance within the settings page.

Your bookmarks and data are automatically persisted in the local-backend/data/ directory, which is mounted as a volume in the Docker container.