VAGRANT-PACKAGE(1)

📦
version 0.33 · 2 versions
, in ubuntu noble

✨ vagrant-package — the manual, but make it cute ✨

okay bestie, so this is a page from the FreedomBox Manual (section 1, we're fancy), and it's all about vagrant-package, a lil script that takes your VirtualBox disk image and goes ✨poof✨ — now it's a Vagrant box. no cap.

🌸 NAME 🌸

vagrant-package — convert a VirtualBox disk image into a Vagrant box 💅

🦋 SYNOPSIS 🦋

vagrant-package [image] [--distribution DISTRIBUTION]
                [--release-components COMPONENT...] [--output OUTPUT]
                [-h, --help]

like. look at her. she's so simple. she's so iconic. 🎀

💖 DESCRIPTION 💖

so first, context, because i love context and you deserve it:

FreedomBox is a community project to develop, design and promote personal servers running free software for private, personal communications. it's a networking appliance designed to let you interface with the rest of the Internet while keeping your privacy protected and your data secure. we're talking blog, wiki, website, social network, email, web proxy and a Tor relay — all hosted on a device that can literally replace your wireless router, so your data stays with you. main character energy honestly. 👑

freedom-maker is the tool that builds FreedomBox images for various single board computers, virtual machines and general purpose computers.

and then there's this script, vagrant-package, which lets you convert a VirtualBox disk image into a Vagrant box. that's it. that's her whole job. and she does it beautifully. 🫶

✨ OPTIONS ✨

  • image — the disk image file (.vdi) that's getting converted. this is the glow-up candidate. 🦋
  • --distribution DISTRIBUTION — the Debian release used in the built image. default is unstable. (yes, living dangerously, we respect it.) 💀
  • --release-components COMPONENT... — the release components used in the apt sources list.
  • --output OUTPUT — the path of the output vagrant box file. default is package.box. 📦
  • -h, --help — the classic. help. we love her. 💜

🌈 EXAMPLES 🌈

Example 1. Convert amd64 VirtualBox disk image into Vagrant box

$ vagrant-package freedom-maker-amd64.vdi --output
      freedom-maker-amd64.box

look at that. one command. box secured. slay. 🔥

💀 BUGS 💀

head over to the freedom-maker issue tracker[1] for the full list of known issues and TODO items. (yes there are TODO items, she's a work in progress, we love a girl who's evolving. 🙈)

👑 AUTHOR 👑

FreedomBox Developers — absolute legends, fr fr.

🎀 NOTES 🎀

  1. freedom-maker issue tracker https://salsa.debian.org/freedombox-team/freedom-maker/-/issues

and that's the whole page, bestie!! 💖 this was version 0.32, dated 02/09/2024, straight from the FreedomBox Manual. go forth and convert your disk images, you gorgeous genius. periodt. ✨🦋🌸

📦 where this page comes from