<mediawiki xmlns="http://www.mediawiki.org/xml/export-0.11/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mediawiki.org/xml/export-0.11/ http://www.mediawiki.org/xml/export-0.11.xsd" version="0.11" xml:lang="en">
  <siteinfo>
    <sitename>bwCloud-OS</sitename>
    <dbname>wikidb</dbname>
    <base>https://wiki.bwcloud-os.de/index.php/Main_Page</base>
    <generator>MediaWiki 1.44.0</generator>
    <case>first-letter</case>
    <namespaces>
      <namespace key="-2" case="first-letter">Media</namespace>
      <namespace key="-1" case="first-letter">Special</namespace>
      <namespace key="0" case="first-letter" />
      <namespace key="1" case="first-letter">Talk</namespace>
      <namespace key="2" case="first-letter">User</namespace>
      <namespace key="3" case="first-letter">User talk</namespace>
      <namespace key="4" case="first-letter">BwCloud-OS</namespace>
      <namespace key="5" case="first-letter">BwCloud-OS talk</namespace>
      <namespace key="6" case="first-letter">File</namespace>
      <namespace key="7" case="first-letter">File talk</namespace>
      <namespace key="8" case="first-letter">MediaWiki</namespace>
      <namespace key="9" case="first-letter">MediaWiki talk</namespace>
      <namespace key="10" case="first-letter">Template</namespace>
      <namespace key="11" case="first-letter">Template talk</namespace>
      <namespace key="12" case="first-letter">Help</namespace>
      <namespace key="13" case="first-letter">Help talk</namespace>
      <namespace key="14" case="first-letter">Category</namespace>
      <namespace key="15" case="first-letter">Category talk</namespace>
      <namespace key="3000" case="first-letter">Intern</namespace>
      <namespace key="3001" case="first-letter">Intern talk</namespace>
    </namespaces>
  </siteinfo>
  <page>
    <title>Main Page</title>
    <ns>0</ns>
    <id>87</id>
    <revision>
      <id>1735</id>
      <parentid>1723</parentid>
      <timestamp>2026-01-20T15:24:04Z</timestamp>
      <contributor>
        <username>Admin</username>
        <id>2</id>
      </contributor>
      <origin>1735</origin>
      <model>wikitext</model>
      <format>text/x-wiki</format>
      <text bytes="4857" sha1="np33q949jksstr9bp414a3qjmetlwtj" xml:space="preserve">__NOTOC__
= bwCloud-OS User Wiki =
Welcome to the '''bwCloud-OS User Wiki -''' the central guide to using the multi-region '''O'''pen'''S'''tack '''cloud''' shared across '''B'''aden-'''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.

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  and related projects is available on the [https://bwcloud-os.de/ '''bwCloud-OS website'''].

If you need technical assistance beyond what is covered here, please open a support '''ticket''' via the [https://bw-support.scc.kit.edu/ '''bwSupportPortal'''].

== Quickstart ==
&lt;span id="Quickstart"&gt;&lt;/span&gt;

&lt;br&gt; 

{{Box
|id=register1
|title=I. Register and/or Log in
|content=
&lt;ol&gt;
  &lt;li&gt;Go to the bwCloud-OS [https://portal.bw-cloud.org/ Dashboard].&lt;/li&gt;
  &lt;li&gt;Select '''bwIDM via OpenID Connect''' and click '''Sign In'''.&lt;/li&gt;
  &lt;li&gt;Choose your home institution and log in with your university credentials.&lt;/li&gt;
&lt;li&gt;If logging in for the first time, register for &lt;strong&gt;bwCloud SCOPE&lt;/strong&gt; by accepting the terms of use.&lt;/li&gt;
  &lt;li&gt;After login or registration, you will be redirected to the bwCloud-OS Dashboard.&lt;/li&gt;
&lt;/ol&gt;
&lt;br&gt;
See the [[Registration|Registration page]] for more details.
}}


{{Box
|id=register2
|title=II. Upload or Create an SSH Key
|content=
&lt;ol&gt;
  &lt;li&gt;Log in to the [https://portal.bw-cloud.org/ Dashboard].&lt;/li&gt;
  &lt;li&gt;Go to &lt;strong&gt;Project → Compute → Key Pairs&lt;/strong&gt;.&lt;/li&gt;
  &lt;li&gt;
    Choose one of the following options:
    &lt;ul&gt;
      &lt;li&gt;&lt;strong&gt;To import an existing key&lt;/strong&gt;: Click &lt;strong&gt;Import Public Key&lt;/strong&gt;, enter a name, select &lt;strong&gt;SSH Key&lt;/strong&gt; type, and upload your '''''public''''' SSH key. Then click &lt;strong&gt;Import&lt;/strong&gt;.&lt;/li&gt;
      &lt;li&gt;&lt;strong&gt;To create a new key pair&lt;/strong&gt;: Click &lt;strong&gt;Create Key Pair&lt;/strong&gt;, enter a name, select &lt;strong&gt;SSH Key&lt;/strong&gt; type, and click &lt;strong&gt;Create&lt;/strong&gt;. The '''''private''''' key will be downloaded automatically.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Make sure the private key is securely stored and accessible on your local machine.&lt;/li&gt;
&lt;/ol&gt;
&lt;br&gt;For help generating an SSH key, see our [[Guide: SSH#Key-Pair-Creation|SSH Guide]].
}}


{{Box
|id=register3
|title=III. Launch a Virtual Machine
|content=

&lt;ol&gt;
  &lt;li&gt;
    Go to &lt;strong&gt;Compute → Instances → Launch Instance&lt;/strong&gt; and fill out the tabs:
    &lt;ol type="a" style="margin-left: 1.5em;"&gt;
      &lt;li&gt;&lt;strong&gt;Details&lt;/strong&gt;: Assign a name&lt;/li&gt;
      &lt;li&gt;&lt;strong&gt;Source&lt;/strong&gt;: Choose an image (e.g., ''Debian 12'')&lt;/li&gt;
      &lt;li&gt;&lt;strong&gt;Flavor&lt;/strong&gt;: Select a resource package (e.g., ''m1.small'')&lt;/li&gt;
      &lt;li&gt;&lt;strong&gt;Networks&lt;/strong&gt;: Choose the appropriate  network&lt;/li&gt;
      &lt;li&gt;&lt;strong&gt;Key Pair&lt;/strong&gt;: Select your SSH key&lt;/li&gt; &lt;/ol&gt;
  &lt;/li&gt;
  &lt;li&gt;Click &lt;strong&gt;Launch&lt;/strong&gt; and wait for the instance to finish building and enter &lt;strong&gt;Running&lt;/strong&gt; state.&lt;/li&gt;
&lt;/ol&gt;
&lt;br&gt;For full details on managing instances, see  the [[Instances (VMs)|Instances page]]. 
}}


{{Box
|id=register4
|title=IV. Connect to Your VM
|content=
Connect to your VM via SSH from a terminal using the following command:

&lt;pre style="background-color: #f9f9f9; border: 1px solid #ccc; padding: 0.5em;"&gt;
ssh -i /path/to/private-key &amp;lt;user&amp;gt;@&amp;lt;address&amp;gt;
&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;&lt;user&gt;&lt;/code&gt; is the default username, e.g. &lt;code&gt;ubuntu&lt;/code&gt; for Ubuntu images. For other images, see the [[Images|Image Overview]].
&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&lt;address&gt;&lt;/code&gt; is the DNS name ([[Networks#FQDN|FQDN]]) or the public IP address of your running instance. Both can be found in the [https://portal.bw-cloud.org/ Dashboard], on the &lt;strong&gt;Instances&lt;/strong&gt; page. 
&lt;/li&gt;
 &lt;/ul&gt;
&lt;/p&gt;
&lt;br&gt;For (advanced) SSH connection methods, see our [[Guide: SSH|SSH Guide]].
}}


== Topic Hub '''–''' Sections ==  
&lt;span id="Theme-Hub"&gt;&lt;/span&gt;

* '''🆔 [[Registration]]''' '''–''' Identity Management, Entitlements, Regions
* '''🖥️ [[Instances (VMs)]] –''' Launching Virtual Machines (VMs), Access to VMs (SSH), Flavors, Images
* '''🌐 [[Networks]]''' '''–''' IPs, FQDNs &amp; DNS, Public and Private Networks
* '''[[Security|🛡️ Security]]''' '''–''' Open and Closed Ports, Security Groups, Security Incidents
* '''💾 [[Storage]]''' '''–''' Volumes, Snapshots, Backups
* '''👥''' '''[[Projects and Quota|Projects &amp; Quota]]''' '''–''' Projects, Group Management, Quota Changes
* '''⚙️ [[Programmatic Access and Automation|Automation]]''' '''–''' API Access, Automation Tools (e.g., Ansible, Terraform)
* '''📖 [[Glossary|Glossary]]''' '''–''' Key Terms Used in bwCloud-OS</text>
      <sha1>np33q949jksstr9bp414a3qjmetlwtj</sha1>
    </revision>
  </page>
</mediawiki>
