sdkman-native.github.io/install.html at master · sdkman-native/sdkman-native.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
<!DOCTYPE html>
<html class=" js flexbox canvas canvastext webgl no-touch geolocation postmessage websqldatabase indexeddb hashchange history draganddrop websockets rgba hsla multiplebgs backgroundsize borderimage borderradius boxshadow textshadow opacity cssanimations csscolumns cssgradients cssreflections csstransforms csstransforms3d csstransitions fontface generatedcontent video audio localstorage sessionstorage webworkers applicationcache svg inlinesvg smil svgclippaths" lang="en"><!--<![endif]--><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Installation - SDKMAN! the Software Development Kit Manager</title>
    <link href="https://sdkman.io/assets//img/favicon.ico" type="image/x-ico" rel="icon">
    <link rel="stylesheet" type="text/css" href="assets/files/bootstrap.css">
    <link rel="stylesheet" type="text/css" href="assets/files/font-awesome.min.css">
    <link rel="stylesheet" type="text/css" href="assets/files/style.css">
</head>

<body style="">
<div id="fork-me">
    <a href="https://github.com/sdkman-native/sdkman-native-cli">
        <img style="position: fixed; top: -14px; right: -14px; border: 0; z-index: 100" src="assets/img/forkme_right_red_aa0000.png" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png">
    </a>
</div>

<div id="st-container" class="st-container st-effect-9">

    <div class="st-pusher">
        <div class="st-content">
            <div class="st-content-inner">
                <!--[if lt IE 7]>
<p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a
        href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
<![endif]-->

                <div>
                    <div class="navbar navbar-default navbar-static-top" role="navigation">
    <div class="container">
        <div class="navbar-header">
            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                <span class="sr-only"></span><span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
            </button>
            <a class="navbar-brand" href="index.html">
                <img class="sdk-logo" src="assets/img/sdk-man-small-pattern.png">
            </a>
        </div>
        <div class="navbar-collapse collapse">
            <ul class="nav navbar-nav navbar-right">
                <li class=""><a href="install.html">Install</a></li>
                <li class=""><a href="jdks.html">JDKs</a></li>
                <li class=""><a href="sdks.html">SDKs</a></li>
                <li class=""><a href="usage.html">Usage</a></li>
                <li class=""><a href="vendors.html">Vendors</a></li>
            </ul>
        </div>
    </div>
</div>


<div id="content" class="page-1">
    <div class="row">
        <div class="row-fluid">
            <div class="col-lg-3"></div>
            <div class="col-lg-8 col-lg-pull-0">
                <h1><i class="fa fa-cloud-download"></i> Installation</h1>

                <article><p>Installing SDKMAN! on UNIX-like platforms is as easy as ever.
                    SDKMAN! installs smoothly on Mac OSX, Linux, WLS, Cygwin,
                    Solaris and FreeBSD. We also support Bash and ZSH shells.<br>Simply open a new
                    terminal and enter: </p>
                    <pre><code>$ curl -s "https://get.sdkman.io" | bash</code></pre>
                    <p>Follow the instructions on-screen to complete installation.<br>Next, open a
                        new terminal <b>or</b> enter:</p>
                    <pre><code>$ source "$HOME/.sdkman/bin/sdkman-init.sh"</code></pre>
                    <p>Lastly, run the following code snippet to ensure that installation
                        succeeded:</p>
                    <pre><code>$ sdk version</code></pre>
                    <p>If all went well, the version should be displayed. Something like:</p>
                    <pre><code>  sdkman 5.0.0+51</code></pre>
                </article>
                <article><h3>Windows Installation</h3>
                    <p>Several options exist for installing SDKMAN! on Windows today.</p>
                    <p>The first solution involves installing <a href="https://docs.microsoft.com/en-us/windows/wsl/install-win10">Windows Linux Subsystem</a>
                        (WLS) prior to attempting SDKMAN installation. You need a basic toolchain including bash, zip,
                        unzip, and curl (tar and gzip required for special cases). Most likely it will work out
                        of the box.</p>
                     <p>Another solution involves installing <a href="https://www.cygwin.com/install.html">Cygwin</a> prior to
                        attempting SDKMAN installation. For our software to function, we require
                        that Cygwin is installed with the same toolchain as described for WLS.</p>
                    <p>The third solution is for Git users using the <a href="https://git-scm.com/download/win">Git Bash for Windows</a>
                        environment. In order for this to work, the environment needs to be
                        supplemented with <a href="http://www.mingw.org/">MinGW</a> to add the
                        necessary toolchain to function.</p>
                    <p><strong>Please be aware that as SDKMAN is written in bash, it requires a bash environment
                        to be present. SDKMAN can not be installed natively on Windows and requires WLS, Cygwin or MSYS+MinGW.</strong></p></article>
                <article><h3>Beta Channel</h3>
                    <p>For the more adventurous among us, we have a beta channel.
                        All new CLI features will first be rolled out to this group of users for
                        trial purposes.
                        Beta versions can be considered stable for the most part, but might
                        occasionally break.
                        To join the beta program, simply update the the
                        <code>~/.sdkman/etc/config</code> file as follows:
                    </p><pre><code>sdkman_beta_channel=true</code></pre>
                    Next, open a new terminal and perform a forced update with:
                    <pre><code>$ sdk selfupdate force</code></pre>
                    To leave the beta channel, simply set the above config back to
                    <code>false</code> and follow the same procedure.<p></p></article>
                <article><h3>Uninstallation</h3>In the unlikely event that you would like to
                    uninstall SDKMAN!, we don't have
                    an automated way of doing this yet. If you really do want to remove it from your
                    system, it is very easy to do so.The following will guide you through backing
                    up, then removing the entire installation from your system.
                    <pre><code>
tar zcvf ~/sdkman-backup_$(date +%F-%kh%M).tar.gz -C ~/ .sdkman
$ rm -rf ~/.sdkman</code></pre>
                    The last step involves editing and removing the initialisation snippet from your
                    <code>.bashrc</code>, <code>.bash_profile</code> and/or <code>.profile</code>
                    files. If you use ZSH, remove it from the <code>.zshrc</code> file. The snippet
                    of code to be removed looks something like this:
                    <pre><code>
#THIS MUST BE AT THE END OF THE FILE FOR SDKMAN TO WORK!!!
[[ -s "/home/dudette/.sdkman/bin/sdkman-init.sh" ]] &amp;&amp; source "/home/dudette/.sdkman/bin/sdkman-init.sh"</code></pre>
                    Once removed, you have successfully uninstalled SDKMAN! from your machine.
                </article>
                <article><h3>Installing to a Custom Location</h3>It is possible to install SDKMAN!
                    to a custom location other than <code>$HOME/.sdkman</code>. This can be achieved
                    by exporting your custom location as <code>SDKMAN_DIR</code> prior to
                    installing.<br>Simply open a new terminal and enter:
                    <pre><code>$ export SDKMAN_DIR="/usr/local/sdkman" &amp;&amp; curl -s "https://get.sdkman.io" | bash</code></pre>
                    For this to work it is vital that your user has full access rights to this
                    folder.It is also important that the folder does not exist as SDKMAN! will
                    attempt to create it.
                </article>
                <p>That's all there is to it! Next we will look at <a href="https://sdkman.io/usage">Usage</a>.
                </p></div>
        </div>
    </div>
</div>

                    <footer id="footer">
    <div class="row">
        <div class="clearfix">© 2012 - 2020 SDKMAN! is Open Source Software licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0.html">Apache 2</a></div>
        <div class="clearfix">Logos and additional Design by <a href="https://github.com/dmesu">Daida
            Medina</a></div>
    </div>
</footer>

                </div>
            </div>
        </div>
    </div>
</div>
<script src="assets/files/jquery-1.10.2.min.js.download" defer=""></script>
<script src="assets/files/classie.js.download" defer=""></script>
<script src="assets/files/bootstrap.js.download" defer=""></script>
<script src="assets/files/sidebarEffects.js.download" defer=""></script>
<script src="assets/files/modernizr-2.6.2.min.js.download" defer=""></script>
<script src="assets/files/plugins.js.download" defer=""></script>
<script src="assets/files/script.js.download"></script>

</body></html>