Main Page: Difference between revisions

From bwCloud-OS
Jump to navigation Jump to search
mNo edit summary
Admin (talk | contribs)
No edit summary
Line 8: Line 8:


== Quickstart ==
== Quickstart ==
<hr style="border: 1px solid #1e3a8a;">


<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; border-radius: 8px; box-shadow: 0 2px 6px rgba(0,0,0,0.1); padding: 0.75em 1em; margin: 1em 0;">
<br>
<strong>I. Register and/or Log in</strong>
 
<div class="mw-collapsible-content" style="margin-top: 0.5em;"><ol>
{{Box
   <li>Go to the bwCloud-OS [https://bw-cloud.org/q/d Dashboard].</li>
|id=register1
   <li>Select <strong>bwIDM via OpenID Connect</strong> and click '''Sign In'''.</li>
|title=I. Register and/or Log in
|content=
<ol>
   <li>Go to the bwCloud-OS Dashboard.</li>
   <li>Select '''bwIDM via OpenID Connect''' and click '''Sign In'''.</li>
   <li>Choose your home institution and log in with your university credentials.</li>
   <li>Choose your home institution and log in with your university credentials.</li>
  <li>If logging in for the first time: register for <strong>bwCloud SCOPE</strong> by accepting the terms of use.</li>
</ol>For more details about registering, see [[Registration|here]].
  <li>After login or registration, you will be redirected to the bwCloud-OS Dashboard.</li>
}}
</ol>For more details about registering, see [[Registration|here]].  
 
</div>
</div>


<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; border-radius: 8px; box-shadow: 0 2px 6px rgba(0,0,0,0.1); padding: 0.75em 1em; margin: 1em 0;">
{{Box
<strong>II. Upload or Create an SSH Key</strong>
|id=register2
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
|title=II. Upload or Create an SSH Key
|content=
<ol>
<ol>
   <li>Log in to the [https://bw-cloud.org/q/d Dashboard].</li>
   <li>Log in to the [https://bw-cloud.org/q/d Dashboard].</li>
Line 38: Line 40:
</ol>
</ol>
For help generating an SSH key, see our '''[[Quickstart: Store SSH key pair|SSH Key Pair Generation guide]].'''
For help generating an SSH key, see our '''[[Quickstart: Store SSH key pair|SSH Key Pair Generation guide]].'''
}}


</div>
</div>


<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; border-radius: 8px; box-shadow: 0 2px 6px rgba(0,0,0,0.1); padding: 0.75em 1em; margin: 1em 0;">
{{Box
<strong>III. Launch a Virtual Machine</strong>
|id=register3
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
|title=III. Launch a Virtual Machine
|content=
 
<ol>
<ol>
   <li>
   <li>
Line 56: Line 59:
   </li>
   </li>
   <li>Click <strong>Launch</strong> and wait for the instance to finish building and enter <strong>Running</strong> state.</li>
   <li>Click <strong>Launch</strong> and wait for the instance to finish building and enter <strong>Running</strong> state.</li>
</ol></div>For full details on managing instances, see the [[Instances (VMs)|Instances guide.]]
</ol>Everything you need to know about instances can be found [[Instances (VMs)|here]].
</div>


<div class="mw-collapsible mw-collapsed" style="border: 1px solid #1e3a8a; border-radius: 8px; box-shadow: 0 2px 6px rgba(0,0,0,0.1); padding: 0.75em 1em; margin: 1em 0;">
}}
<strong>IV. Connect to Your VM</strong>
 
<div class="mw-collapsible-content" style="margin-top: 0.5em;">
 
{{Box
|id=register4
|title=IV. Connect to Your VM
|content=
<ol>
<ol>
   <li>Find the '''''public''''' IP address of your running instance in the <strong>Instances</strong> overview.</li>
   <li>Find the '''''public''''' IP address of your running instance in the <strong>Instances</strong> overview.</li>
Line 73: Line 79:
</ol>
</ol>
</p>
</p>
</div>
 
</div>
}}


== Theme Hub ==   
== Theme Hub ==   

Revision as of 14:29, 15 October 2025

bwCloud-OS User Wiki

Welcome to the bwCloud-OS User Wiki — the central knowledge base for using the multi-region OpenStack cloud shared across the state of Baden-Württemberg, Germany. This cloud is jointly operated by the universities of Freiburg, Karlsruhe, Mannheim, and Ulm, and is available to users from all participating educational institutions in the state.

This wiki is primarily designed to answer frequently asked questions (FAQs) and provide practical guidance for common tasks when using the bwCloud-OS service. General information about the bwCloud-OS service and affiliated projects is available on the bwCloud-OS website.

If you need technical assistance beyond what is covered here, please open a support ticket via the bwSupportPortal.

Quickstart


I. Register and/or Log in

  1. Go to the bwCloud-OS Dashboard.
  2. Select bwIDM via OpenID Connect and click Sign In.
  3. Choose your home institution and log in with your university credentials.
For more details about registering, see here.


II. Upload or Create an SSH Key

  1. Log in to the Dashboard.
  2. Go to Project → Compute → Key Pairs.
  3. Choose one of the following options:
    • To import an existing key: Click Import Public Key, enter a name, , select SSH Key type, and upload your public SSH key. Then click Import.
    • To create a new key pair: Click Create Key Pair, enter a name, select SSH Key type, and click Create. The private key will be downloaded automatically.
  4. Ensure you have access to the private key on your local machine.

For help generating an SSH key, see our SSH Key Pair Generation guide.


III. Launch a Virtual Machine

  1. Go to Compute → Instances → Launch Instance and fill out the tabs:
    1. Details: Assign a name
    2. Source: Choose an image (e.g., Debian 12)
    3. Flavor: Select a resource package (e.g., m1.small)
    4. Networks: Choose the network
    5. Key Pair: Select your SSH key
  2. Click Launch and wait for the instance to finish building and enter Running state.
Everything you need to know about instances can be found here.


IV. Connect to Your VM

  1. Find the public IP address of your running instance in the Instances overview.
  2. Connect via SSH from your terminal using the following command:
  3. ssh -i /path/to/private-key <user>@<IP-address>
    

    For Debian/Ubuntu images, the default username is debian or ubuntu. See our full Username Overview for other images.

Theme Hub


Other Notes


  • Glossary - Key terms and concepts used in bwCloud-OS