Metadata-Version: 2.4
Name: lugnut
Version: 0.1.0rc1
Summary: Self-hosted vehicle maintenance tracker
Author: nevoodoo
Author-email: nevoodoo <nevoodoo@users.noreply.github.com>
License-Expression: MIT
Requires-Dist: alembic>=1.20.1
Requires-Dist: argon2-cffi>=25.1.0
Requires-Dist: fastapi>=0.162.0
Requires-Dist: pydantic-settings>=2.16.1
Requires-Dist: python-multipart>=0.0.32
Requires-Dist: sqlalchemy>=2.1.6
Requires-Dist: tzdata>=2026.5
Requires-Dist: uvicorn>=0.54.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# Lugnut

> **Lugnut is in active development. Use it with caution and keep your own backups.** So far it covers first-run setup and login.

A self-hosted vehicle maintenance and running-cost tracker. One process, SQLite, no other services.

## Quick start

Once the first release candidate is out, you can run it with Docker:

```sh
docker run -d --name lugnut -p 8080:8080 -v lugnut-data:/data \
  -e LUGNUT_SECURE_COOKIES=false \
  ghcr.io/nevoodoo/lugnut:rc
```

Or with uv:

```sh
LUGNUT_SECURE_COOKIES=false uvx --prerelease=allow lugnut serve
```

There's no release yet. The first release candidate is coming.

The `latest` image tag appears after the first stable release. Until then, `uvx` needs `--prerelease=allow`. With pip, use `pip install --pre lugnut`. Drop the flag once a stable release exists.

Then open http://localhost:8080. The examples turn off the Secure flag on the session cookie because plain HTTP would otherwise break login. Leave that variable out if you serve HTTPS. See the [install docs](https://nevoodoo.github.io/lugnut/install/docker/) for details.

## Docs

https://nevoodoo.github.io/lugnut, including the [roadmap](https://nevoodoo.github.io/lugnut/roadmap/).

## Coming from LubeLogger?

Importing a LubeLogger instance (backup zip or API) is planned and not available yet. Details are on the [docs page](https://nevoodoo.github.io/lugnut/coming-from-lubelogger/).

## Contributing

Pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).

## Licence

[MIT](LICENSE)
