Git Product home page Git Product logo

virtkick-starter's Introduction

VirtKick. Take Cloud Back.

GPA Dependencies status Gratipay

VirtKick is a simple, open source orchestrator. Managing virtual machines or Docker containers has never been easier.

That's the VirtKick Starter. It will allow you to start using VirtKick with a single click.

This is a heavy work in progress and not yet one-click install. Don't judge - it will be improved! Please report an issue if you face any problems. We need your help to make it bullet-proof. Thanks! :-)

Distro specific prerequisites

Ubuntu 14.04

Most things are already handled by virtkick-start, you only need Git.

sudo apt-get install git

Other

Over time we plan to add streamlined installation for other distros as well. General rule of thumb is to have a development environment (make, g++), libvirt and qemu. virtkick-starter will try to setup rest by itself.

First run

  1. git clone https://github.com/virtkick/virtkick-starter.git
  2. cd virtkick-starter
  3. ./virtkick-start -dim

First start may take a couple of minutes due to download of various dependencies. It will ask for root password to setup things in setup/system.sh, as you may inspect. During run it will also download iso images to /home/virtkick/iso, make sure you have enough disk space left (~25 GB).

After everything is set up, open up http://localhost:3000/ and try out virtkick by creating a virtual machine or two. :) Happy hacking!

Next runs

  1. ./virtkick-start -dm

Upgrading

  1. git pull
  2. ./virtkick-start -dim

Hacker Zone™

See ./virtkick-start -h for other options.

Some environment variables may be set to customize:

  • PORT - reverse proxy listen port (defaults to 3000)
  • RAILS_PORT - Rails web application listen port (defaults to 60000)
  • WORKER_COUNT - number of background jobs workers (defaults to 2)
  • NO_DOWNLOAD - skip download of iso files to /home/virtkick/iso

Contributing

See CONTRIBUTING.md. Thanks!

Sponsors

  • Tip us weekly with Gratipay: Donate with Gratipay
  • One-time donate with PayPal: Donate with PayPal
  • Or with Bitcoins: 1Nb7PxyNAKSNc6traXW4NPyPMhJA7PwXf8
  • Become a corporate sponsor.

Thanks for your support!

License

VirtKick, a simple orchestrator. Copyright (C) 2014 StratusHost Damian Nowak

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/agpl-3.0.html.

Trademark

The VirtKick name and logo are trademarks of Damian Nowak. You may not use them for promotional purposes, or in any way that claims, suggests or looks like there's a relationship or endorsement by VirtKick.

Other marks and names mentioned herein may be trademarks of their respective companies.

virtkick-starter's People

Contributors

rush avatar nowaker avatar

Watchers

James Cloos avatar Amit Patra avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.