<commit_before>---
title: Get Started with Project Atomic
---

%h1 Get Started with Atomic

%img.pull-right( src="/images/platforms.png")

%p.lead 
  Atomic can run on the same platforms and clouds as the distributions it is based on.

%p.lead
  Download an Atomic Fedora 20 VM now.

%p 
  The "QEMU" image works on Linux KVM virtualization, for example 
  <a href="http://openstack.redhat.com/">RDO</a> (OpenStack), 
  <a href="http://ovirt.org">oVirt</a>, 
  <a href="http://virt-manager.org/">virt-manager</a> and
  the "Boxes" virtual machine application available on 
  <a href="http://fedoraproject.org/">Fedora 20</a>.

.clearfix

%p.buttons.hidden-xs
  %a.btn.btn-primary.btn-lg{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/vbox"} VirtualBox (Win, Mac)
  %a.btn.btn-primary.btn-lg{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/qemu"} QEMU (Linux)
%p.buttons.visible-xs
  %a.btn.btn-primary.btn-block{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/vbox"} VirtualBox (Win, Mac)
  %a.btn.btn-primary.btn-block{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/qemu"} QEMU (Linux)

%p Stay tuned for more distributions and optimized images for cloud environments.

.clearfix

.row
  .col-md-12.sm-12
    %h2 Setting Up the Virtual Machine

    %p
      Please follow the
      %a( href="/docs/quickstart/" ) Quick Start Guide
      to create a new virtual machine with Atomic and set
      up more disk space for your containers.

    %h3 Extremely Quick Start Guide For the Impatient

    %p Atomic boots to a text console, asking you to log in:
    %pre
    
      Localhost login: root <span class="text-muted">[press enter]</span>

    %p
      There is no password by default.

    %p
      Even though remote login via ssh is disabled with a blank password,
      it makes sense to set one now:

    %pre
      \# passwd root
      Changing password for user root.
      New password: <span class="text-muted">[enter a new password ]</span>
      Retype new password: <span class="text-muted">[ enter the password again ]</span>
     
  .col-md-6.col-sm-12
    %h2 Atomic Upgrades

    %p
      From a running host, start an upgrade with:
    %pre
      $ rpm-ostree upgrade
      $ systemctl reboot
    %p
      On the boot screen you'll see your new version. Hold down the
      SHIFT key there to rollback to your previous tree.

    %p 
      %a( href="/docs/os-updates" ) &raquo; More on atomic upgrades with OSTree...

  .col-md-6.col-sm-12
    %h2 Docker Containers

    %p
      Host applications on Atomic with #{link_to "Docker", "https://www.docker.io"}
    %pre
      :preserve
        $ docker run fedora /bin/echo "hello world"
    %p
      Get familiar with the #{link_to "Docker tutorial", "https://www.docker.io/gettingstarted/#"}, then
      learn how you can build reusable images and run Docker in production on Atomic hosts.

    %p 
      %a( href="/docs/#docker" ) &raquo; Read about Docker in production...

.row
  .col-md-6.col-sm-12
    %h2 Try the New UI for Your Server

    %p
      Administer the services on your system with Cockpit (Preview - not for production use)

    %pre
      :preserve
        # setenforce 0 
        # systemctl enable cockpit.socket
        # visit http://&lt;ipaddress&gt;:21064 in a browser
    %p
      Cockpit is perfect for new sysadmins, allowing them to easily perform simple tasks such as storage 
      administration, inspecting journals and starting and stopping services.

    %p
      The snapshot of Cockpit the project is here is a preview - do
      not use in production environments.  Cockpit is under rapid
      development, with work on security hardening and reliability
      ongoing.

    %p <commit_msg>download: Fix syntax error in Cockpit text<commit_after>---
title: Get Started with Project Atomic
---

%h1 Get Started with Atomic

%img.pull-right( src="/images/platforms.png")

%p.lead 
  Atomic can run on the same platforms and clouds as the distributions it is based on.

%p.lead
  Download an Atomic Fedora 20 VM now.

%p 
  The "QEMU" image works on Linux KVM virtualization, for example 
  <a href="http://openstack.redhat.com/">RDO</a> (OpenStack), 
  <a href="http://ovirt.org">oVirt</a>, 
  <a href="http://virt-manager.org/">virt-manager</a> and
  the "Boxes" virtual machine application available on 
  <a href="http://fedoraproject.org/">Fedora 20</a>.

.clearfix

%p.buttons.hidden-xs
  %a.btn.btn-primary.btn-lg{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/vbox"} VirtualBox (Win, Mac)
  %a.btn.btn-primary.btn-lg{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/qemu"} QEMU (Linux)
%p.buttons.visible-xs
  %a.btn.btn-primary.btn-block{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/vbox"} VirtualBox (Win, Mac)
  %a.btn.btn-primary.btn-block{:href => "http://rpm-ostree.cloud.fedoraproject.org/project-atomic/images/f20/qemu"} QEMU (Linux)

%p Stay tuned for more distributions and optimized images for cloud environments.

.clearfix

.row
  .col-md-12.sm-12
    %h2 Setting Up the Virtual Machine

    %p
      Please follow the
      %a( href="/docs/quickstart/" ) Quick Start Guide
      to create a new virtual machine with Atomic and set
      up more disk space for your containers.

    %h3 Extremely Quick Start Guide For the Impatient

    %p Atomic boots to a text console, asking you to log in:
    %pre
    
      Localhost login: root <span class="text-muted">[press enter]</span>

    %p
      There is no password by default.

    %p
      Even though remote login via ssh is disabled with a blank password,
      it makes sense to set one now:

    %pre
      \# passwd root
      Changing password for user root.
      New password: <span class="text-muted">[enter a new password ]</span>
      Retype new password: <span class="text-muted">[ enter the password again ]</span>
     
  .col-md-6.col-sm-12
    %h2 Atomic Upgrades

    %p
      From a running host, start an upgrade with:
    %pre
      $ rpm-ostree upgrade
      $ systemctl reboot
    %p
      On the boot screen you'll see your new version. Hold down the
      SHIFT key there to rollback to your previous tree.

    %p 
      %a( href="/docs/os-updates" ) &raquo; More on atomic upgrades with OSTree...

  .col-md-6.col-sm-12
    %h2 Docker Containers

    %p
      Host applications on Atomic with #{link_to "Docker", "https://www.docker.io"}
    %pre
      :preserve
        $ docker run fedora /bin/echo "hello world"
    %p
      Get familiar with the #{link_to "Docker tutorial", "https://www.docker.io/gettingstarted/#"}, then
      learn how you can build reusable images and run Docker in production on Atomic hosts.

    %p 
      %a( href="/docs/#docker" ) &raquo; Read about Docker in production...

.row
  .col-md-6.col-sm-12
    %h2 Try the New UI for Your Server

    %p
      Administer the services on your system with Cockpit (Preview - not for production use)

    %pre
      :preserve
        # setenforce 0 
        # systemctl enable cockpit.socket
        # visit http://&lt;ipaddress&gt;:21064 in a browser
    %p
      Cockpit is perfect for new sysadmins, allowing them to easily perform simple tasks such as storage 
      administration, inspecting journals and starting and stopping services.

    %p
      The snapshot of Cockpit included in Atomic is a preview - do
      not use in production environments.  Cockpit is under rapid
      development, with work on security hardening and reliability
      ongoing.

    %p 
{'fraction_non_alphanumeric': 0.10811163275952008, 'fraction_numerical': 0.009650495565988524, 'mean_word_length': 2.78903162055336, 'pattern_counts': {'":': 0, '<': 31, '<?xml version=': 0, '>': 39, 'https://': 4, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 3, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4915636', 'n_tokens_mistral': 2567, 'n_tokens_neox': 2382, 'n_words': 833}