khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-03 10:20:02 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1667 from owncloud/appliance

Browse Source 
typo & formatting corrections
This commit is contained in:
Carla Schroder
2015-09-14 09:47:43 -07:00
parent 41f97b7754 dbaaacf53b
commit 3d338af112
1 changed files with 40 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
admin_manual/installation/appliance_installation.rst
View File

@@ -1,55 +1,69 @@
============================
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.
============================
ownCloud has a publicly developed community appliance `on GitHub`_. Download the
latest release from the Appliances tab on 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.
1. Download the Virtual Machine image zip file and unpack it.
2. Start VirtualBox and click on *File ...* > *Import Appliance* and import
your new ownCloud image.
3. Click the green Start arrow. After a minute you should see the console
greeting message.
.. figure:: images/community-vm-console.png
:alt: screenshot of Ubuntu console login for newly-created virtual machine
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.
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 Web page 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%
:alt: screenshot of new virtual machine Web GUI with login credentials
*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:: You should write down your admin password, and make 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.
.. 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 administer the VM via SSH.
**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 unofficial pre-made virtual machine-based appliances:
- `SUSE Studio, ownCloud on openSuSE`_, runnable directly from an USB stick.
- `SUSE Studio, ownCloud on openSuSE`_, which runs directly from an USB stick.
- `Amahi home server`_
- `ownCloud VM on Ubuntu 14.04 with MySQL and Apache`_, fully configured from start
.. ownCloud on Hardware Appliances
.. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. These are tutorials provided by the user communities of the respective appliances:
.. - `ownCloud 7 on Raspberry Pi (Arch Linux) using Lighttpd`_ for the popular credit-card sized computer
.. - `QNAP Guide`_ for QNAP NAS appliances
.. - `OpenWrt Guide`_ for the popular embedded distribution for routers and NAS devices.
.. - `Synology Package`_ for Synology NAS products
- `ownCloud VM on Ubuntu 14.04 with MySQL and Apache`_, fully configured
environment.
.. _on Github: https://github.com/ownCloud/vm
.. _VirtualBox: https://www.virtualbox.org