# apt-ostree Debian Package

Debian packaging for apt-ostree, the Debian/Ubuntu equivalent of rpm-ostree.

## 🎯 **Project Overview**

This repository contains the Debian packaging files for apt-ostree, enabling it to be distributed as a proper Debian package through the Forgejo Debian repository.

## 📁 **Project Structure**

```
apt-ostree-deb/
├── README.md                 # This file
├── build.sh                  # Main build script
├── debian/                   # Debian packaging files
│   ├── control              # Package metadata and dependencies
│   ├── changelog            # Version history
│   ├── copyright            # License information
│   ├── rules                # Build rules
│   └── source/              # Source package configuration
├── .github/                  # GitHub Actions CI/CD
│   └── workflows/
│       └── build.yml        # Automated build workflow
└── output/                  # Generated .deb packages
```

## 🚀 **Quick Start**

### **Build apt-ostree Package:**
```bash
# Clone the repository
git clone <your-repo> apt-ostree-deb
cd apt-ostree-deb

# Build the package
./build.sh

# Result: output/apt-ostree_0.1.0-1_amd64.deb
```

### **Install the Package:**
```bash
# Install the built package
sudo dpkg -i output/apt-ostree_0.1.0-1_amd64.deb

# Resolve dependencies if needed
sudo apt-get install -f
```

## 🔧 **Development**

### **Prerequisites:**
- Ubuntu 24.04 LTS or Debian 12
- build-essential, devscripts, debhelper
- Rust toolchain (cargo, rustc)

### **Build Process:**
1. **Source Preparation**: Copy apt-ostree source code
2. **Package Configuration**: Set up debian/ directory
3. **Build Package**: Run dpkg-buildpackage
4. **Test Package**: Install and test functionality
5. **Upload**: Push to Forgejo repository

## 🎯 **Goals**

- [x] **Basic Packaging**: Debian package structure
- [ ] **CI/CD Pipeline**: Automated builds and uploads
- [ ] **Repository Integration**: Forgejo Debian repository
- [ ] **Testing**: Package validation and testing
- [ ] **Documentation**: User and developer guides

## 🤝 **Contributing**

This project follows standard Debian packaging practices. Contributions are welcome!

## 📄 **License**

Same license as apt-ostree project. 