> A self-hosted drive. Upload, sync, share, trash, recover. SQLite by default: one container, one volume, no database server to babysit.
> Source: https://orochibraru.com/penombre/docs · Site index: https://orochibraru.com/llms.txt

# Penombre documentation

A self-hosted drive. Upload, sync, share, trash, recover. SQLite by default: one container, one volume, no database server to babysit.

The Markdown in [the project repo](https://github.com/orochibraru/penombre/tree/main/docs) is the source of truth;
these pages are generated from it.

- [Penombre](https://orochibraru.com/penombre/docs/readme.md): A self-hosted drive. All the convenience of cloud storage, on hardware you own, with a bill of exactly zero.
- [Contributing](https://orochibraru.com/penombre/docs/contributing.md): Unit tests preload test.setup.ts (see bunfig.toml), which mocks $app//#lib/server/ and the Drizzle db object; they need no database or Redis. bunfig.toml also…
- [Getting Started](https://orochibraru.com/penombre/docs/getting-started.md): Spin up a Penombre instance in minutes with Docker Compose.
- [Showcase](https://orochibraru.com/penombre/docs/showcase.md): Every screenshot below is generated by driving a real instance with Playwright (bun run screenshots) against a library seeded with one dummy file of each…
- [Simple Mode](https://orochibraru.com/penombre/docs/simple-mode.md): Run Penombre as a bare shared file browser instead of a multi-user drive.
- [Environment Variables](https://orochibraru.com/penombre/docs/env.md): Configure your Penombre instance with environment variables.
- [Deployment](https://orochibraru.com/penombre/docs/deployment.md): Deploy Penombre to production with Docker.
- [Reverse Proxy](https://orochibraru.com/penombre/docs/reverse-proxy.md): Expose Penombre behind a reverse proxy with HTTPS.
- [Storage](https://orochibraru.com/penombre/docs/storage.md): Where Penombre keeps your files.
- [Encryption](https://orochibraru.com/penombre/docs/encryption.md): Penombre can seal file bytes at rest with a key you hold, but start with disk-level encryption on DATADIR: for a stolen or decommissioned drive it covers…
- [Mounted volumes](https://orochibraru.com/penombre/docs/volumes.md): A volume is a directory mounted alongside the main drive. It appears in the sidebar as its own entry, is browsable and searchable like any other folder, and is…
- [Worker](https://orochibraru.com/penombre/docs/worker.md): Penombre offloads CPU- and I/O-heavy byte work to a small Go process rather than doing it inline in the app's request handlers.
- [Troubleshooting](https://orochibraru.com/penombre/docs/troubleshooting.md): Solutions to common Penombre issues.
- [Uploads](https://orochibraru.com/penombre/docs/uploads.md): Uploading is deliberately boring: pick files, they land in the folder you are browsing. Two things about it are worth knowing.
- [Media and notes](https://orochibraru.com/penombre/docs/media.md): Images, video and audio get more than a download link.
- [Documents, sheets and presentations](https://orochibraru.com/penombre/docs/documents.md): Penombre can create and edit three kinds of document in the browser, from the New button in the sidebar.
- [Sharing](https://orochibraru.com/penombre/docs/sharing.md): Penombre shares a file or folder two ways, and the Share dialog has a tab for each:
- [Shared drives](https://orochibraru.com/penombre/docs/shared-drives.md): A shared drive belongs to a group instead of a person. Everyone on it opens the same tree, uploads into the same folders, and sees the same trash — unlike…
- [Notifications](https://orochibraru.com/penombre/docs/notifications.md): The bell in the header tells you when someone else did something to your things. It is deliberately narrow: only events involving another person appear, so your…
- [Admin panel](https://orochibraru.com/penombre/docs/admin.md): Accounts with the admin role get an extra section at /admin, reachable from the user menu. It is hidden entirely when auth is bypassed — nobody signs in under…
- [Authentication](https://orochibraru.com/penombre/docs/authentication.md): Configure authentication methods for your Penombre instance. Penombre supports multiple authentication methods powered by Better Auth.
- [Project architecture](https://orochibraru.com/penombre/docs/architecture.md): Overview of the Penombre project architecture.