# Atuin

Atuin is a shell history tool for developers and homelab users that stores commands in a SQLite database, adds search context, and optionally encrypts and synchronises history between machines via a self-hostable Atuin. It is open source and self-hosted, installable on Kubernetes (Helm) and Unraid.

Canonical page: https://ourlocalhost.com/app/2628/atuin

## Description

Atuin is a shell history tool for developers and homelab users that stores commands in a SQLite database, adds search context, and optionally encrypts and synchronises history between machines via a self-hostable Atuin server.

## Platform availability

Available on 3 of 10 platforms: Unraid, Helm, Any server.

## Health score

71/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 8 days ago)
- Popular: 90 (32,344 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 5 (4 serious findings, 1 minor, CI, tests)

## Security check

4 serious findings: A GitHub access token is committed in the source code; A Slack token is committed in the source code; A private key is committed in the source code; A GitHub access token is committed in the source code.
Automated checks on commit e4b9b0f, 12 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/atuinsh/atuin
- Kubernetes (Helm): https://artifacthub.io/packages/helm/rm3l/atuin
- Official website: https://atuin.sh/
- Unraid: https://ca.unraid.net/apps/atuin-1l8bioz0eatf27?q=atuin
- Documentation: https://docs.atuin.sh

## Common questions

### Why might Atuin not record commands in IDE terminals?

IDE terminals often start non-interactive shells that do not source your shell configuration, so Atuin's hooks are never installed. Configure the IDE to start an interactive shell.

### What permission issue should I fix before starting a self-hosted Atuin Docker container?

Create the config folder and run chown 1000:1000 on it before starting the container, because the container uses user and group ID 1000. If it cannot write there, startup can fail or data may be lost.

### What extra step is needed after a native Atuin server install?

Run atuin-server start so the server is actually listening for connections. Without this step, clients cannot sync or store history.

### Do I have to run an Atuin sync server to use Atuin?

No, you can use Atuin without sync. You may host your own server or not use sync at all.

### Can Atuin import existing shell history?

Yes, the quickstart uses atuin import auto to import history. The docs also have an import history guide.

## Alternatives

- hiSHtory: hiSHtory is a better shell history.
- hstr: Are you looking for a command that you used recently?

---
Source: Our Local Host (https://ourlocalhost.com/app/2628/atuin), the self-hosted and open-source app directory.
