From ae580741b7979390955f6f7a4a14422537295bf7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tomek=20W=C3=B3jcik?= Date: Tue, 25 Nov 2025 11:05:19 +0000 Subject: [PATCH] Add Getting Started --- Getting-Started.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 Getting-Started.md diff --git a/Getting-Started.md b/Getting-Started.md new file mode 100644 index 0000000..1bc9f57 --- /dev/null +++ b/Getting-Started.md @@ -0,0 +1,29 @@ +# Getting Started with HotPocket + +This document provides instructions for setting up HotPocket, so you can start saving your links. + +HotPocket's main UI is the Web Application. At the time of writing, there are no known public instances of HotPocket. You'll need to set one up yourself. See below for information to get you started. + +## Setting up the Web Application + +HotPocket is designed for self-hosting. It supports almost any kind of environment - from one-container setups on a single node to full-stack setups. + +The Web application (also known as HotPocket Backend) is packages as a Docker images. They're available publicly on Docker Hub - [bthlabs/hotpocket](https://hub.docker.com/r/bthlabs/hotpocket). The images support `linux/amd64` and `linux/arm64` architectures. + +There are two modes of the Docker image - `aio` and `deployment`. The `aio` image is suitable for small setups, with a few users. The `deployment` image is designed for full-stack setups. Both modes are compatible with Docker Compose, Kubernetes and other container runtimes. + +Docker images are tagged and pushed on release. + +The documentation on Docker Hub provides extensive description of the images. It also provides links to example setups in the project's repository. + +## Available apps and extensions + +HotPocket provides the following apps and extensions to make your time saving links easier: + +* Official iOS, iPadOS and macOS companion apps for Safari and Share extensions - [HotPocket by BTHLabs](https://apps.apple.com/pl/app/hotpocket-by-bthlabs/id6752321380). +* Official extension for Firefox - [Save to HotPocket](https://addons.mozilla.org/en-GB/firefox/addon/save-to-hotpocket/). +* Official extension for Chrome and Chromium-based - [Save to HotPocket](https://chromewebstore.google.com/detail/save-to-hotpocket/mkmoejhhgnadmijpgkkioicjmikkkjbd). + +## Progressive Web Application + +HotPocket Backend is a Progressive Web Application. It can be installed from the browser and it'll register itself as share target. This is currently supported on Android and Windows 11. \ No newline at end of file