diff options
| author | Mohamed Bassem <me@mbassem.com> | 2025-04-05 18:09:53 +0000 |
|---|---|---|
| committer | Mohamed Bassem <me@mbassem.com> | 2025-04-05 18:10:23 +0000 |
| commit | 27324a963120fe7a6aeff7cfbe358db5b3fafe7a (patch) | |
| tree | 4b3a8ef7f17ecc7c8f796af79e93429b0c587930 /docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md | |
| parent | 8a2b890256d89487343f3772e76b79e0bbcb0c2c (diff) | |
| download | karakeep-27324a963120fe7a6aeff7cfbe358db5b3fafe7a.tar.zst | |
docs: Release the 0.23.1 docs
Diffstat (limited to 'docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md')
| -rw-r--r-- | docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md b/docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md new file mode 100644 index 00000000..147c1621 --- /dev/null +++ b/docs/versioned_docs/version-v0.23.1/02-Installation/07-minimal-install.md @@ -0,0 +1,49 @@ +# Minimal Installation + +:::warning +Unless necessary, prefer the [full installation](/Installation/docker) to leverage all the features of hoarder. You'll be sacrificing a lot of functionality if you go with the minimal installation route. +::: + +Hoarder's default installation has a dependency on Meilisearch for the full text search, Chrome for crawling and OpenAI/Ollama for AI tagging. You can however run hoarder without those dependencies if you're willing to sacrifice those features. + +- If you run without meilisearch, the search functionality will be completely disabled. +- If you run without chrome, crawling will still work, but you'll lose ability to take screenshots of websites and websites with javascript content won't get crawled correctly. +- If you don't setup OpenAI/Ollama, AI tagging will be disabled. + +Those features are important for leveraging hoarder's full potential, but if you're running in constrained environments, you can use the following minimal docker compose to skip all those dependencies: + +```yaml +services: + web: + image: ghcr.io/hoarder-app/hoarder:release + restart: unless-stopped + volumes: + - data:/data + ports: + - 3000:3000 + environment: + DATA_DIR: /data + NEXTAUTH_SECRET: super_random_string +volumes: + data: +``` + +Or just with the following docker command: + +```base +docker run -d \ + --restart unless-stopped \ + -v data:/data \ + -p 3000:3000 \ + -e DATA_DIR=/data \ + -e NEXTAUTH_SECRET=super_random_string \ + ghcr.io/hoarder-app/hoarder:release +``` + +:::warning +You **MUST** change the `super_random_string` to a true random string which you can generate with `openssl rand -hex 32`. +::: + +Check the [configuration docs](/configuration) for extra features to enable such as full page archival, full page screenshots, inference languages, etc. + + |
