LibreLock Server

REST API for LibreLock, a secure, self-hosted password manager. Built with Go and Gin, backed by PostgreSQL.

Get started

Refer to Get started section in this README for one command setup of the entire application. Keep reading if you wish to run the backend separately.

The preferable way to run LibreLock Server is via Docker Compose.

cp .env.example .env  # then update with your DB credentials
docker compose up -d --build

To run without Docker first install Go and PostgreSQL, then set up a database and user matching the one if .env. Finally, run the server with:

go run main.go

The API is now running at localhost:8000. PostgreSQL data persists in a Docker volume across restarts.

Contributing

See CONTRIBUTING.md for project structure, code style, and security guidelines.