{"id":15048378,"url":"https://github.com/github/veewee","last_synced_at":"2025-10-04T08:31:32.568Z","repository":{"id":17712879,"uuid":"20529805","full_name":"github/veewee","owner":"github","description":"Easing the building of vagrant boxes","archived":true,"fork":true,"pushed_at":"2014-06-05T15:12:52.000Z","size":4567,"stargazers_count":13,"open_issues_count":0,"forks_count":10,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-09-25T21:11:06.082Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jedi4ever/veewee","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/github.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"License","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-06-05T15:10:59.000Z","updated_at":"2024-07-31T03:22:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/github/veewee","commit_stats":null,"previous_names":[],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fveewee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fveewee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fveewee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fveewee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/github","download_url":"https://codeload.github.com/github/veewee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219876581,"owners_count":16554769,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T21:11:13.338Z","updated_at":"2025-10-04T08:31:30.792Z","avatar_url":"https://github.com/github.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Veewee\n\n[![Build Status](https://travis-ci.org/jedi4ever/veewee.png)](https://travis-ci.org/jedi4ever/veewee)\n\nVeewee is a tool for easily (and repeatedly) building custom [Vagrant](https://github.com/mitchellh/vagrant) base boxes, KVMs, and virtual machine images.\n\n\n## About Vagrant\n\nVagrant is a great tool for creating and configuring lightweight, reproducible, portable virtual machine environments - often used with the addition of automation tools such as [Chef](https://github.com/opscode/chef) or [Puppet](https://github.com/puppetlabs/puppet).\n\nThe first step to build a new virtual machine is to download an existing 'base box'. I believe this scares a lot of people as they don't know how these unverified boxes were built. Therefore a lot of people end up building their own base box which is often time consuming and cumbersome. Veewee aims to automate all the steps for building base boxes and to collect best practices in a transparent way.\n\n\n## Veewee's Supported VM Providers\n\nVeewee isn't only for Vagrant.  It currently supports exporting VM images for the following providers:\n\n* [VirtualBox](http://www.virtualbox.org/) - exports to `OVF` filetype\n* [VMware (Fusion)](http://www.vmware.com/products/fusion/) - exports to `OVA` filetype\n* [KVM](http://www.linux-kvm.org/) - exports to `IMG` filetype\n* [Parallels](http://www.parallels.com/) - none yet, but can export to `parallels` format (provided by [vagrant-parallels](https://github.com/yshahin/vagrant-parallels))\n\n\n## Getting Started\n\nBefore you start, we recommend reading through these pages:\n\n* [Requirements](doc/requirements.md) that must be met before installing Veewee\n* [Veewee Installation](doc/installation.md) instructions\n* [Command Options](doc/commands.md) highlights various approaches for executing Veewee on the command line\n\nNext, learn about Veewee fundamentals:\n\n* [Veewee Basics](doc/basics.md) covers creating standard-issue boxes\n* [Customizing Definitions](doc/customize.md) helps you fine tune each box definition to meet your exact needs\n* [Veeweefile](doc/veeweefile.md) can be used to define your own paths\n\nThen depending on how you want to use Veewee, we suggest to read through one of the following guides:\n\n* [Guide for Vagrant](doc/vagrant.md)\n* [Guide for VirtualBox](doc/vbox.md)\n* [Guide for VMware Fusion](doc/fusion.md)\n* [Guide for KVM](doc/kvm.md)\n* [Guide for Parallels Desktop](doc/parallels.md)\n\nMajor noteworthy changes between versions can be found here:\n\n* [Changes](doc/changes.md) between versions\n\nA complete list of all docs can be found by viewing the [doc directory](doc).\n\n\n## Veewee Commands\n\nBelow is an overview of the `veewee` command options:\n\n    $ bundle exec veewee\n\n    # Commands:\n    #   veewee add_share       # Adds a Share to the Guest\n    #   veewee fusion          # Subcommand for Vmware fusion\n    #   veewee help [COMMAND]  # Describe available commands or one specific command\n    #   veewee kvm             # Subcommand for KVM\n    #   veewee parallels       # Subcommand for Parallels\n    #   veewee vbox            # Subcommand for VirtualBox\n    #   veewee version         # Prints the Veewee version information\n\nLearn how to avoid typing `bundle exec` by visiting the [Commands](doc/commands.md) doc.\n\n\n## Veewee Provider Subcommands\n\nBelow is an overview of the `veewee` provider subcommand options:\n\n    $ bundle exec veewee \u003cprovider\u003e\n\n    # Commands:\n    #   veewee \u003cprovider\u003e build [BOX_NAME]                 # Build box\n    #   veewee \u003cprovider\u003e copy [BOXNAME] [SRC] [DST]       # Copy a file to the VM\n    #   veewee \u003cprovider\u003e define [BOXNAME] [TEMPLATE]      # Define a new basebox starting from a template\n    #   veewee \u003cprovider\u003e destroy [BOXNAME]                # Destroys the basebox that was built\n    #   veewee \u003cprovider\u003e halt [BOXNAME]                   # Activates a shutdown on the basebox\n    #   veewee \u003cprovider\u003e help [COMMAND]                   # Describe subcommands or one specific subcommand\n    #   veewee \u003cprovider\u003e list                             # Lists all defined boxes\n    #   veewee \u003cprovider\u003e ostypes                          # List the available Operating System types\n    #   veewee \u003cprovider\u003e screenshot [NAME] [PNGFILENAME]  # Takes a screenshot of the box\n    #   veewee \u003cprovider\u003e ssh [BOXNAME] [COMMAND]          # Interactive ssh login\n    #   veewee \u003cprovider\u003e templates                        # List the currently available templates\n    #   veewee \u003cprovider\u003e undefine [BOXNAME]               # Removes the definition of a basebox\n    #   veewee \u003cprovider\u003e up [BOXNAME]                     # Starts a Box\n    #   veewee \u003cprovider\u003e validate [NAME]                  # Validates a box against vagrant compliancy rules\n    #   veewee \u003cprovider\u003e winrm [BOXNAME] [COMMAND]        # Execute command via winrm\n\n\n## Contribute\n\nPeople have reported good experiences, why don't you give it a try?\n\nIf you have a setup working, share your 'definition' with me. That would be fun!\n\nSee [CONTRIBUTE.md](CONTRIBUTE.md).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fveewee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithub%2Fveewee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fveewee/lists"}