diff --git a/admin_manual/installation/appliance_installation.rst b/admin_manual/installation/appliance_installation.rst index e9052aa07..eb6b38ae2 100644 --- a/admin_manual/installation/appliance_installation.rst +++ b/admin_manual/installation/appliance_installation.rst @@ -1,46 +1,46 @@ -ownCloud Appliances +ownCloud Community Appliance =================== +ownCloud has a publically developed community appliance `on GitHub`_. Download the latest release from the Appliances tab at the `ownCloud server installation page`_. The easiest way to get the VM up and running is by using `VirtualBox`_ and downloading the OVA image from the installation page. + +Instructions for VirtualBox and OVA +~~~~~~~~~~~~~~~~~~~ + +Follow these steps to get the appliance working: + +1. Download the Virtual Machine image zip file and unpack it +2. Start VirtualBox and click on *File ...* > *Import Appliance ...* +3. Click the green Start arrow. After a minute you should see the console greeting message. + +.. figure:: images/community-vm-console.png + +4. Note the username and password here. It is a random password that we generate for you on first boot. + If you log in at the console, you'll be prompted to change the password. This is optional. +5. With your web-browser try ``http://localhost:8888`` or ``http://localhost:80`` or the addess printed on the console. + One of them should work. If not, please review and adjust the network setup of virtualbox to bridged mode. +6. You should see a webpage with login credentials (if you haven't changed them already) and a list of URLs to try to reach the ownCloud web service. Which one works, again depends on the network setup of your hypervisor. + +.. figure:: images/community-vm-splash.png + :scale: 50% + + *Click to enlarge* + +.. note:: Before diving into ownCloud, please consider memorizing the admin password, and cmake sure the login credentials are no longer displayed. Click the *[Hide Credentials]* button. When using the ownCloud Proxy app, this web-page may be publicly visible. + +.. note:: Inside the VM, ownCloud runs with a default disk size of 40 GB and its own mysql database. The ownCloud admin user is also a valid account on the ubuntu system that runs inside the VM. You can ssh into the machine and do sudo from there, and administrate the system. + +**For VMware** + +You can follow most of the steps above, however, after opening the VMX file, you will have to configure ``Bridged Network`` as *Network Adapter* Software Appliances ~~~~~~~~~~~~~~~~~~~ -There are a number of pre-made virtual machine-based appliances: +There are a number of unofficial pre-made virtual machine-based appliances: - `SUSE Studio, ownCloud on openSuSE`_, runnable directly from an USB stick. - `Amahi home server`_ - `ownCloud VM on Ubuntu 14.04 with MySQL and Apache`_, fully configured from start -ownCloud community VM -~~~~~~~~~~~~~~~~~~~ - -ownCloud has publically developed a community appliance on GitHub. Download the latest release here: - -- `ownCloud community VM`_ - -Instructions -~~~~~~~~~~~~~~~~~~~ - -To be able to use it, you have to follow these steps: - -**If you use VirtualBox** - -1. Double click on the .ovf file -2. Import -3. Then open VirtualBox -4. Network -5. Bridged Network - -**If you use VMware** - -1. Double click on the .vmx file -2. Network Adapter -3. Bridged Network - -After the VM is booted a plain Ubuntu console appears, showing you the IP-address and initial login credentials. Here you have some options: - -- Follow the instructions on screen. -- Direct your web browser to the IP-address shown in the console which will bring you to a basic web-page there with further instructions. - .. ownCloud on Hardware Appliances .. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -51,9 +51,9 @@ After the VM is booted a plain Ubuntu console appears, showing you the IP-addres .. - `OpenWrt Guide`_ for the popular embedded distribution for routers and NAS devices. .. - `Synology Package`_ for Synology NAS products - - -.. _ownCloud community VM: https://owncloud.org/install/#instructions-server +.. _on Github: https://github.com/ownCloud/vm +.. _VirtualBox: https://www.virtualbox.org +.. _ownCloud server installation page: https://owncloud.org/install/#instructions-server .. _Amahi home server: https://wiki.amahi.org/index.php/OwnCloud .. _ownCloud VM on Ubuntu 14.04 with MySQL and Apache: https://www.en0ch.se/pre-configured-owncloud-installaton/ .. _ownCloud 7 on Raspberry Pi (Arch Linux) using Lighttpd: http://eiosifidis.blogspot.de/2014/07/install-owncloud-7-on-raspberry-pi-arch.html diff --git a/admin_manual/installation/images/community-vm-console.png b/admin_manual/installation/images/community-vm-console.png new file mode 100644 index 000000000..6dcd5ef7b Binary files /dev/null and b/admin_manual/installation/images/community-vm-console.png differ diff --git a/admin_manual/installation/images/community-vm-splash.png b/admin_manual/installation/images/community-vm-splash.png new file mode 100644 index 000000000..232f9b6e2 Binary files /dev/null and b/admin_manual/installation/images/community-vm-splash.png differ