blob: dc4d24a2131e35ca6fe6fec599987f6e92e57447 [file] [log] [blame]
<!doctype html>
<html ng-app="gettingStarted">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Download and install Eclipse Che for Windows, Mac and Linux.">
<!-- Favicons etc. -->
<link rel="icon" href="../images/ico/16x16.png">
<link rel="icon" sizes="16x16 32x32 64x64" href="../images/ico/16x16.png">
<link rel="apple-touch-icon" sizes="57x57" href="../images/ico/57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="../images/ico/60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="../images/ico/72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="../images/ico/76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="../images/ico/114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="../images/ico/120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="../images/ico/144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="../images/ico/152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="../images/ico/180x180.png">
<link rel="icon" type="image/png" href="../images/ico/196x196.png" sizes="196x196">
<link rel="icon" type="image/png" href="../images/ico/192x192.png" sizes="192x192">
<link rel="icon" type="image/png" href="../images/ico/144x144.png" sizes="144x144">
<link rel="icon" type="image/png" href="../images/ico/96x96.png" sizes="96x96">
<link rel="icon" type="image/png" href="../images/ico/72x72.png" sizes="72x72">
<link rel="icon" type="image/png" href="../images/ico/48x48.png" sizes="48x48">
<link rel="icon" type="image/png" href="../images/ico/36x36.png" sizes="36x36">
<link rel="icon" type="image/png" href="../images/ico/32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="../images/ico/16x16.png" sizes="16x16">
<link rel="manifest" href="../images/ico/manifest.json">
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="../images/ico/144x144.png">
<meta name="theme-color" content="#ffffff">
<!-- Always force latest IE rendering engine or request Chrome Frame -->
<meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">
<!-- Use title if it's in the page YAML frontmatter -->
<title>Eclipse Che | Get Started with Eclipse Che</title>
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
<link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:300' rel='stylesheet' type='text/css'>
<link href="../stylesheets/all.css" rel="stylesheet" />
<link href="css/factory.css" rel="stylesheet" />
<script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.4.8/angular.min.js"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="scripts/factories.js"></script>
<script src="../javascripts/bootstrap.min.js"></script>
<!-- Equal Height for Content Script -->
<script type="text/javascript">
$(document).ready(function(){
var leaderHeight = $(".leader p").height();
$(".border p").height( leaderHeight);
return false;
});
</script>
<!-- Tracking Snippets Below -->
<!-- GOOGLE TAG MANAGER -->
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-T9PJ53"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-T9PJ53');</script>
<!-- END GOOGLE TAG MANAGER -->
<!-- MARKETO MUNCHKIN -->
<script type="text/javascript">
$.ajax({
url: '//munchkin.marketo.net/munchkin.js',
dataType: 'script',
cache: true,
success: function() {
Munchkin.init('519-AYY-549');
}
});
</script>
</head>
<body class="getting-started-cloud getting-started-cloud_index">
<header>
<div class="container-fluid">
<a class="logo" href="../"><img alt="Eclipse Che" src="../images/logo-eclipseche.svg" /></a>
<nav class="menu-mobile">
<a class="mobile-menu-toggle" data-toggle="collapse" aria-expanded="false" href="#mobileMenuItems"><i class="fa fa-bars"></i></a>
<ul class="mobile-menu-items collapse" id="mobileMenuItems">
<li><a href="../features/">Features</a></li>
<li><a href="../download/">Downloads</a></li>
<li><a target="_blank" href="https://eclipse-che.readme.io/docs/">Docs</a></li>
<li><a href="../community/">Community</a></li>
<li><a href="../blog/">Blog</a></li>
<li><a href="./">Get Started with <span>Eclipse Che<span></a></li>
</ul>
</nav>
<nav class="menu-desktop">
<ul>
<li><a href="../features/">Features</a></li>
<li><a href="../download/">Downloads</a></li>
<li><a target="_blank" href="https://eclipse-che.readme.io/docs/">Docs</a></li>
<li><a href="../community/">Community</a></li>
<li><a href="../blog/">Blog</a></li>
<li><iframe src="https://ghbtns.com/github-btn.html?user=eclipse&repo=che&type=star&count=true" frameborder="0" scrolling="0" width="100px" height="20px"></iframe></li>
<li><a class="btn-outline-dark" href="./">Get Started with <span>Eclipse Che<span></a></li>
</ul>
</nav>
</div> <!-- /.container-fluid -->
</header> <!-- /header -->
<div class="jumbotron">
<div class="container-fluid">
<h1>Get Started with Eclipse Che</h1>
<h3>Use Eclipse Che workspaces at <a href="https://codenvy.com/" target="_blank">codenvy.com</a> or run Che on Windows, Mac or Linux.</h3>
</div> <!-- /.container-fluid -->
</div> <!-- /.jumbotron -->
<hr class="gray">
<div class="container-fluid content">
<h2>How to Get Help</h2>
<p><b>Issues:</b> Sometimes the unexpected happens. If it does, post <a href="https://github.com/eclipse/che/issues">issues to our GitHub page</a>. Please <a href="https://github.com/eclipse/che/blob/master/CONTRIBUTING.md">follow the issue reporting guidelines.</a></p>
<p><b>Documentation:</b> We put a lot of effort <a href="https://eclipse-che.readme.io/">into our docs</a>. If there are improvements or errors, we'd love that feedback.</p>
<p><b>Chat:</b> Che engineers hang out on <a href="https://gitter.im/eclipse/che?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge">Gitter</a>, <a href="http://qwebirc.swiftirc.net/?nick=fromwebsite&channels=%23eclipseche">IRC</a> and Slack.</p>
<div class="separator"></div>
<ul class="row tabs">
<li class="col-xs-6 active">
<div class="cloud">
<h3 class="active"><a href="#tab1" data-toggle="tab">Try Eclipse Che in the Cloud</a></h3>
<p class="hidden-xs">Codenvy hosts Eclipse Che workspaces with free accounts.</p>
</div>
</li>
<li class="col-xs-6">
<div class="download">
<h3><a href="#tab2" data-toggle="tab">Download Eclipse Che</a></h3>
<p class="hidden-xs">Install binaries from an Eclipse mirror or build from source.</p>
</div>
</li>
</ul><!-- /.row -->
<div class="tab-content">
<div id="tab1" class="tab-pane fade in active">
<!-- START_CUSTOM_WORKSPACE -->
<div class="block">
<h2>Create Your Own Workspace</h2>
</div>
<div class="row">
<div class="col-md-4 col-sm-6">
<div class="border media">
<div class="media-left">
<img src="../images/getting-started/codenvy.png" alt="Codenvy">
</div>
<div class="media-body">
<h4>Custom</h4>
<p class="small">Create workspaces for any language/framework.</p>
</div>
<a href="http://beta.codenvy.com/site/login" class="btn-green">Create a free account</a>
</div>
</div> <!-- /.col -->
</div> <!-- /.row -->
<!-- END_CUSTOM_WORKSPACE -->
<getting-started-factories></getting-started-factories>
</div> <!-- /#tab1 -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<!-- DIVIDER FOR TABS -->
<div id="tab2" class="tab-pane fade in">
<div class="block">
<h2>Installation Types</h2>
<p><b>Vagrant:</b> The quickest way to try Che on any operating system.
<p><b>Server:</b> The best performance, especially on Docker-native systems.
<p><b>Other:</b> You can run Che in a <a href="https://eclipse-che.readme.io/docs/usage-docker#using-docker-syntax">Docker container</a>. If you are into IoT, Che has a <a href="http://eclipse.org/che/artik/">Samsung ARTIK IDE assembly</a> and also <a href="https://blog.benjamin-cabe.com/2016/04/01/running-eclipse-che-on-a-raspberry-pi">runs on a Raspberry Pi</a>.
<div class="separator"></div>
<div class="block"></div>
<h2>Avoid These Common Setup Gotchas</h2>
<p><b>Windows/Mac:</b> VT-X/AMD-v must be enabled on your laptop. You can change this <a href="https://docs.fedoraproject.org/en-US/Fedora/13/html/Virtualization_Guide/sect-Virtualization-Troubleshooting-Enabling_Intel_VT_and_AMD_V_virtualization_hardware_extensions_in_BIOS.html">in the BIOS</a>.</p>
<p><b>Windows:</b> If VirtualBox fails to create a VM, the most common reason is <a href="http://stackoverflow.com/questions/33725779/failed-to-open-create-the-internal-network-vagrant-on-windows10">NDIS driver bugs</a>.</p>
<p><b>Proxies:</b> Che must download software from the Internet. Configure <a href="https://eclipse-che.readme.io/v4.0/docs/usage#installing-behind-a-proxy">Vagrant's proxy</a>, or if installing as a server, <a href="https://eclipse-che.readme.io/v4.0/docs/configuration-proxies">setup Che's proxies</a>.</p>
<div class="separator"></div>
<div class="block"></div>
<h2>1. Install Che</h2>
<b>Vagrant:</b> First install <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a> and <a href="https://www.vagrantup.com/downloads.html">Vagrant</a>. <a href="https://github.com/eclipse/che/blob/master/Vagrantfile">Place Che's Vagrantfile in an empty directory</a>. Execute <code>vagrant up</code>. The Vagrant installer configures Java, Docker, and the latest released version of Che.</p>
<b>Server:</b> You must first <a href="https://eclipse-che.readme.io/docs/install-pre-reqs">install Java and Docker Toolbox</a>. Then install <a href="https://www.eclipse.org/che/download/">Che from a ZIP file</a>. Another option is that Codenvy provides a <a href="https://install.codenvycorp.com/che/eclipse-che-latest.exe">Windows wizard-based installer that installs both Che and its prerequisites</a>.</p>
<b>Docker:</b> There is syntax for launching a Che container using <a href="https://eclipse-che.readme.io/docs/usage-docker#using-che-scripts">Che's scripts</a>, or <a href="https://eclipse-che.readme.io/docs/usage-docker#using-docker-syntax">with Docker run syntax</a>.</p>
<div class="separator"></div>
<div class="block"></div>
<h2>2. Run Che</h2>
<p><b>Vagrant:</b> Che is already running! <code>http://192.168.28.30:8080</code> will open Che's dashboard.</p>
<p><b>Server:</b> Follow these <a href="https://eclipse-che.readme.io/v4.0/docs/usage-server">usage steps</a>.</p>
<p><a href="../images/features/img-features-docker-powered.png"><img alt="" class="img-responsive" src="../images/features/img-features-docker-powered.png"/></a></p>
</ul>
<div class="separator"></div>
<div class="block"></div>
<h2>3. Create Workspaces and Projects</h2>
<p><b>Create a Workspace:</b> Che provides a step-by-step wizard for creating workspaces. The wizard creates workspaces with ready-to-go runtimes that contain projects that can be compiled, run and debugged. The Java and Node.JS stacks offer the most choice when starting.</p>
<p><b>Problems:</b> If workspace creation fails, it's usually due to network configuration. <a href="https://eclipse-che.readme.io/docs/networking">Review the networking guide for configuring Che in different networks</a>.</p>
<p><b>Tutorials:</b> Step-by-step-by-step tutorials using different developer frameworks such as <a href="https://eclipse-che.readme.io/docs/get-started-with-java-and-che">Java</a>, <a href="https://eclipse-che.readme.io/docs/get-started-with-wordpress-and-che">Wordpress</a>, <a href="https://eclipse-che.readme.io/docs/get-started-with-nodejs-and-che">Node.js</a>, <a href="https://eclipse-che.readme.io/docs/che-and-subversion">Subversion</a>, and many more.</p></p>
<div class="separator"></div>
<div class="block"></div>
<h2>4. Setup Hosted Che</h2>
<p><b>Multiple Users:</b> Run Che as a server with its services remotely accessible. <a href="https://eclipse-che.readme.io/docs/networking">You must change Che's networking</a> to ensure users browser can connect to Che and its workspaces.</p>
<div class="separator"></div>
<div class="block"></div>
<h2>5. Customize Che</h2>
<p><b>Stacks:</b> <a href="https://github.com/eclipse/che/blob/master/CUSTOMIZING.md">Add your own runtimes and templates.</a></p>
<p><b>Plug-Ins:</b> Tool teams can create their own plug-ins which modify the server's behavior, alter the IDE, or inject agents into the hosted workspaces. Plug-ins can add new projects types, change the editor, add version control features and to implement vendor workflows. We have <a href="https://eclipse-che.readme.io/docs/plug-ins">instructions for writing plug-ins and extensions.</a></p>
<p><b>Assemblies:</b> You can create your own distributable packages of Che with custom stacks, plug-ins, or Che core modifications. The <a href="http://github.com/codenvy/artik-ide">Samsung ARTIK IDE is an example.</a> You can <a href="https://eclipse-che.readme.io/docs/assemblies">create custom assemblies with the SDK.</a></p>
<div class="separator"></div>
<div class="block"></div>
<h2>6. Contribute to Che</h2>
<p><b>Build Che From Source:</b> We love that idea. Che is a multi-module project, so you can build all of it, or just some of it. We maintain build instructions in our <a href="https://github.com/eclipse/che">GitHub repository.</a></p>
<p><b>Contribute:</b> We also love this. You can contribute in many ways: documentation, writing articles, creating plug-ins, solving bugs, or getting into the core feature roadmap. We maintain a document that outlines how <a href="https://github.com/eclipse/che/blob/master/CONTRIBUTING.md">you contribute to Che.</a> Also, our roadmap and weekly meeting minutes are maintained <a href="https://github.com/eclipse/che/wiki">on the Che wiki.</a></p>
</div><!-- /#tab2 -->
</div><!-- /.tab-content -->
</div><!-- /.container-fluid -->
</div>
<div class="twitter-share">
<h6><i class="fa fa-twitter"></i> Was this page helpful? <a href="https://twitter.com/share">Share it on Twitter</a></h6>
</div>
<footer>
<div class="container-fluid">
<a class="logo" href="../"><img alt="Eclipse Che" src="../images/logo-eclipseche.svg" /></a>
<p class="tagline">Next-Generation Eclipse IDE</p>
<div class="sitemap">
<ul>
<li><a href="../features/">Features</a></li>
<li><a href="../download/">Downloads</a></li>
<li><a target="_blank" href="https://eclipse-che.readme.io/docs/">Docs</a></li>
<li><a href="../community/">Community</a></li>
<li><a href="../blog/">Blog</a></li>
</ul>
</div>
<a class="btn-outline-dark" href="./">Get Started with <span>Eclipse Che<span></a>
<div class="copyright">Copyright &copy; Eclipse Foundation 2016</div>
</div> <!-- /.container-fluid -->
</footer> <!-- /footer -->
</body>
</html>