Librebucket

A lightweight, self-hosted Git server with a clean web interface, built with Go.

Are you tired of big companies playing with your repositories, by removing them or trading with your data? Want to provide a small and free Git hosting for your community, friends or company? Then Librebucket (/ˈliːbrə ˈbʌkɪt/) for you, we promise that Librebucket will be "independent Free/Libre Software forever"!

Getting Started

Prerequisites

• Go 1.22 or later
• Git 2.20 or later
• A operating system (Linux, macOS, Windows, even Raspberry/Orange Pi!)

Installation

TODO: add instructions for installation

Creating Your First Repository

1. Use the API to create a new repository:

   curl -X POST http://localhost:3000/api/v1/git/create \
     -H "Content-Type: application/json" \
     -d '{"username":"yourusername", "reponame":"yourrepo"}'

2. Clone your new repository:

   git clone http://localhost:3000/yourusername/yourrepo.git
   cd yourrepo

3. Make some changes and push:

   echo "# My Project" > README.md
   git add .
   git commit -m "Initial commit"
   git push -u origin main

Web Interface

Access the web interface at http://localhost:3000 to browse repositories, view code, and manage your projects.

Configuration

TODO: do the configuration

Development

Building

go build -o librebucket cmd/librebucket/main.go

Running Tests

go test ./...

Code Style

This project follows the Google Go Style Guide.

Security

• All repository access is private by default
• HTTPS is recommended for secure communication
• Authentication and authorization features coming soon

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

Repo Activity

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with the amazing Go programming language
• Inspired by Forgejo and other self-hosted Git solutions
• Uses the go-git library for Git operations