After you have installed ownCloud you might realize that it would be nice to
provide an additional function on top of the core functionality in your ownCloud installation.
The first step should be to check out the ownCloud apps store (http://apps.owncloud.com/). There you will find a lot of ready-to-use apps provided by the ownCloud community.
The first step should be to check out the `ownCloud apps store <http://apps.owncloud.com/>`_. There you will find a lot of ready-to-use apps provided by the ownCloud community.
Parameters
----------
@@ -44,7 +44,7 @@ If you want to allow the installation of apps from the apps store you have to
set **appstoreenabled** parameter, but this can only be done if at least one
of the configured apps directories is writeable.
The **appstoreurl** is used to set the http path to the ownCloud apps store. The appstore server has to use OCS (Open Collaboration Services).
The **appstoreurl** is used to set the http path to the ownCloud apps store. The appstore server has to use :abbr:`OCS (Open Collaboration Services)`.
@@ -6,7 +6,7 @@ might run into a problem where he needs to consult the documentation or knowledg
Parameters
----------
If you want to disable the ownCloud help menu item you can use the **knowledgebaseenabled** parameter inside the :file:`config/config.php`. The **knowledgebaseurl** parameter is used to set the http path to the ownCloud help page. The server should support OCS (Open Collaboration Services).
If you want to disable the ownCloud help menu item you can use the **knowledgebaseenabled** parameter inside the :file:`config/config.php`. The **knowledgebaseurl** parameter is used to set the http path to the ownCloud help page. The server should support :abbr:`OCS (Open Collaboration Services)`.
..note:: ready-to-use SLES and openSUSE RPM packages are available
in the openSUSE Build Service `ownCloud repository`_.
..note:: ready-to-use SLES and openSUSE RPM packages are available in the openSUSE Build Service `ownCloud repository`_.
1. Copy ownCloud to Apache's server directory : ``/srv/www/htdocs``
2. Give the web server the necessary permissions:
``sudo chown -R wwwrun owncloud``
#. Copy ownCloud to Apache's server directory : **/srv/www/htdocs**
#. Give the web server the necessary permissions:
- If you do not use "sudo" then you have to become root and
execute: ``chown -R wwwrun owncloud`` in the directory.
- (If you’re using mysql, you have to set the database character set
to something else then utf~8, for example latin1 otherwise some
keys will be to long for mysql)
::
sudo chown -R wwwrun owncloud
3. Open the folder in a browser and complete the setup wizard
If have followed the steps above and want to try it out, run this
command in a terminal to start Apache if it’s not already running:
command in a terminal to start Apache if it’s not already running::
1.``sudo /etc/init.d/apache2 start``
2. Go to ``http://servername/owncloud`` and walk through the setup.
sudo /etc/init.d/apache2 start
Go to http://servername/owncloud and walk through the setup.
Fedora
~~~~~~
..note:: ready-to-use RPM packages are available
in the openSUSE Build Service `ownCloud repository`_.
..note:: ready-to-use RPM packages are available in the openSUSE Build Service `ownCloud repository`_.
Make sure SELinux is disabled or else the installation process will fail
with the following message: ``Config file (config/config.php) is not
writable for the webserver``.
Make sure `SELinux is disabled<https://fedoraproject.org/wiki/SELinux_FAQ#How_do_I_enable_or_disable_SELinux_.3F>`_ or else the installation process will fail with the following message::
Config file (config/config.php) is not writable for the webserver
Configure Apache:
1. If you already have a website running from Document Root but would
still like to install OwnCloud you can use a Name-based virtual host
entry and subdomain.
2. Edit your DNS record following this example: ``point owncloud.foo.com >
ip.ip.ip.ip``
#. If you already have a website running from Document Root but would still like to install OwnCloud you can use a Name-based virtual host entry and subdomain.
#. Edit your DNS record following this example: **point owncloud.foo.com > ip.ip.ip.ip**
..todo::
CentOS 5 & 6
~~~~~~~~~~~~
@@ -64,10 +58,10 @@ CentOS 5 & 6
..note:: ready-to-use CentOS RPM packages are available
in the openSUSE Build Service `ownCloud repository`_.
1. Create a new file in ``/etc/httpd/conf/`` and call it ``owncloud.conf``.
1. Create a new file in **/etc/httpd/conf/** and call it **owncloud.conf**.
2. You can use the following as an example:
::
..code-block::xml
<IfModulemod_alias.c>
Alias /owncloud /var/www/owncloud/
@@ -86,22 +80,25 @@ CentOS 5 & 6
</VirtualHost>
3. Now edit your httpd.conf file which is usually located in
``/etc/httpd/conf/httpd.conf``
4. Add the following to the bottom:
``Include /etc/httpd/conf/owncloud.conf``
5. Restart apache and now when you point your browser to
``owncloud.foo.com`` it should properly load without disturbing *foo.com*
3. Now edit your httpd.conf file which is usually located in:file:`/etc/httpd/conf/httpd.conf`
4. Add the following to the bottom
::
Include /etc/httpd/conf/owncloud.conf
5. Restart apache and now when you point your browser to http://owncloud.foo.com it should properly load without affecting http://foo.com
Gentoo
~~~~~~
Set up a standard web server (see instructions above). Then change permissions::
Basically do everything like for a standard web server (see
..note:: You must move the data directory outside of your public root.
(See advanced install settings)
..note:: You must move the data directory outside of your public root (See advanced install settings)
This section describes how to install ownCloud on Windows with :abbr:`IIS
(Internet Information Services)`.
@@ -11,32 +10,22 @@ It assumes that you have a vanilla, non-IIS enabled Windows
machine – Windows 7 or Server 2008. After enabling IIS, the steps are
essentially identical for Windows 7 and Windows Server 2008.
For installation, physical access or a remote desktop connection is required.
You should leverage MySQL as the back end database for ownCloud.
If you do not want to use MySQL, it is possible to use Postgres or SQLite
instead. Microsoft SQL Server is not yet support.
For installing ownCloud physical access or a remote desktop connection is required. You should leverage MySQL as the backend database for ownCloud. If you do not want to use MySQL, it is possible to use Postgres or SQLite instead. Microsoft SQL Server is not yet support.
Enabling SSL is not yet covered by this section.
..note:: If you make your desktop machine or server available
outside your LAN, you must maintain it. Monitor the logs, manage
the access, apply patches to avoid compromising the system at large.
..note:: If you make your desktop machine or server available outside of your LAN, you must maintain it. Monitor the logs, manage the access, apply patches to avoid compromising the system at large.
There are 4 primary steps to the installation, and then a 5th step
required for configuring everything to allow files larger than the
default 2MB.
1. Install IIS with CGI support – enable IIS on your Windows machine.
2. Install PHP – Grab, download and install PHP.
3. Install MySQL – Setup the MySQL server manager and enable ownCloud to create
#. Install IIS with CGI support – enable IIS on your Windows machine.
#. Install PHP – Grab, download and install PHP.
#. Install MySQL – Setup the MySQL server manager and enable ownCloud to create
an instance.
4. Install ownCloud – The whole reason we are here!
5. Configure upload sizes and timeouts to enable large file uploads – So that you
can upload larger files.
#. Install ownCloud – The whole reason we are here!
#. Configure upload sizes and timeouts to enable large file uploads – So that you can upload larger files.
Activate IIS with CGI Support
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -44,16 +33,16 @@ Activate IIS with CGI Support
Windows 7
^^^^^^^^^
1. Go to :guilabel:`Start --> Control Panel --> Programs`.
#. Go to :guilabel:`Start --> Control Panel --> Programs`.
2. Under Programs and Features, there is link titled :guilabel:`Turn Windows Features on
#. Under Programs and Features, there is link titled :guilabel:`Turn Windows Features on
and Off`. Click on it.
3. There is a box labeled Internet Information Services, expand it.
#. There is a box labeled Internet Information Services, expand it.
4. Expand World Wide Web Services and all the folders underneath.
#. Expand World Wide Web Services and all the folders underneath.
5. Select the folders as illustrated in the picture below to get your IIS
#. Select the folders as illustrated in the picture below to get your IIS
server up and running.
..figure:: ../images/win7features.jpg
@@ -78,10 +67,11 @@ features are the features you would expect from a web server.
With the selections on this page, IIS will now serve up a web page for you.
Restart IIS by going to the IIS manager (:guilabel:`Start --> IIS Manager`).
Select your website, and on the far right side is a section titled
:guilabel:`Manage Server`. Make sure that the service is started, or click
:guilabel:`Start` to start the services selected. Once this is complete, you
should be able to go to a web browser and navigate to `http://localhost``.
should be able to go to a web browser and navigate to http://localhost.
This should open the standard IIS 7 splash page, which is just a static image
that says your web server is running. Assuming you were able to get the
@@ -91,16 +81,16 @@ splash page, it is safe to say your web server is now up and running.
Windows Server 2008
^^^^^^^^^^^^^^^^^^^
1. Go to :guilabel:`Start --> Control Panel --> Programs`.
#. Go to :guilabel:`Start --> Control Panel --> Programs`.
2. Under Programs and Features, there is link titled
#. Under Programs and Features, there is link titled
:guilabel:`Turn Windows Features on and Off`. Click on it.
3. This will bring up the Server Manager.
#. This will bring up the Server Manager.
4. In the server manager, Click on Roles, and then click Add Roles.
#. In the server manager, Click on Roles, and then click Add Roles.
5. Use the :guilabel:`Add Roles Wizard` to add the web server role.
#. Use the :guilabel:`Add Roles Wizard` to add the web server role.
..figure:: ../images/winserverroles.jpg
:width:300px
@@ -110,23 +100,13 @@ Windows Server 2008
Server roles required for ownCloud
6. Make sure that, at a minimum, the same boxes are checked in this wizard that
are checked in the Windows 7 Section. For example, make sure that the CGI
box is checked under Application Development Features, and that WebDAV
Publishing is turned off. With Remote Desktop Sharing turned on, the
detailed role service list looks like the figure “Role Services”.
6. Make sure that, at a minimum, the same boxes are checked in this wizard that are checked in the Windows 7 Section. For example, make sure that the CGI box is checked under Application Development Features, and that WebDAV Publishing is turned off. With Remote Desktop Sharing turned on, the detailed role service list looks like the figure “Role Services”.
7. Restart IIS by going to the IIS manager (:guilabel:`Start --> IIS Manager`).
8. Select your website, and on the far right side is a section titled Manage
Server. Make sure that the service is started, or click “Start” to start the
services selected.
8. Select your website, and on the far right side is a section titled Manage server. Make sure that the service is started, or click “Start” to start the services selected.
9. Once this is complete, you should be able to go to a web browser and type
"localhost". This should open the standard IIS 7 splash page, which is just
a static image that says your web server is running.Assuming you were able
to get the splash page, it is safe to say your web server is now up and
running. The next part of this “how to” installs PHP on the server.
9. Once this is complete, you should be able to go to a web browser and type "localhost". This should open the standard IIS 7 splash page, which is just a static image that says your web server is running.Assuming you were able to get the splash page, it is safe to say your web server is now up and running. The next part of this “how to” installs PHP on the server.
Installing PHP
~~~~~~~~~~~~~~
@@ -134,23 +114,17 @@ Installing PHP
This part is also straightforward, but it is necessary to remind you that this
is for IIS only.
1. Go to the following link and grab the PHP installer for version "VC9 Non
Thread Safe" 32 or 64 bit based on your system.
http://windows.php.net/download/
1. Go to the following link and grab the `PHP installer <http://windows.php.net/download/>`_ for version "VC9 Non Thread Safe" 32 or 64 bit based on your system.
..note:: If you are using Apache, make sure you grab VC6 instead, lower on the
page.
..note:: If you are using Apache, make sure you grab VC6 instead, lower on the page.
2. Once through that login, select the location that is closest to you
geographically.
2. Once through that login, select the location that is closest to you geographically.
3. Run that install wizard once it is downloaded. Read the license agreement,
agree, select an install directory.
3. Run that install wizard once it is downloaded. Read the license agreement, agree, select an install directory.
4. Then select IIS FastCGI as the install server.
4. Then select IIS FastCGI as the install server.
5. Take the default selections for the items to install, and click next. Then
click install.
5. Take the default selections for the items to install, and click next. Then click install.
6. And, after a few minutes, PHP will be installed. On to MySQL.
@@ -159,36 +133,27 @@ Installing MySQL
This part installs MySQL on your Windows machine.
1. Point your browser to http://dev.mysql.com/downloads/ and download the
latest community edition for your OS – the 32 or 64 bit version. Please
download the ``MSI Installer`` as it will make life easier.
#. Point your browser to http://dev.mysql.com/downloads/ and download the latest community edition for your OS – the 32 or 64 bit version. Please download the **MSI Installer** as it will make life easier.
2. Once downloaded, install MySQL (5.5 at the time of writing). Select the
Typical installation.
#. Once downloaded, install MySQL (5.5 at the time of writing). Select the Typical installation.
3. When that finishes, check the box to launch the MySQL Instance Configuration
Wizard and click Finish.
#. When that finishes, check the box to launch the MySQL Instance Configuration Wizard and click Finish.
4. Select a standard configuration, as this will be the only version of MySQL
on this machine.
#. Select a standard configuration, as this will be the only version of MySQL on this machine.
5. Select to install as a windows service, and Check the Launch the MySQL
Server Automatically button.
#. Select to install as a windows service, and Check the Launch the MySQL Server Automatically button.
6. Select the modify security settings box on the next page, and enter a
password you will remember. You will need this password when you configure
ownCloud.
#. Select the modify security settings box on the next page, and enter a password you will remember. You will need this password when you configure ownCloud.
7. Uncheck ``enable`` root access from remote machines” for security reasons.
#. Uncheck **enable** root access from remote machines” for security reasons.
8. Click execute, and wait while the instance is created and launched.
#. Click execute, and wait while the instance is created and launched.
9. Click Finish when this is all complete.
#. Click Finish when this is all complete.
.. You can make some pretty good educated guesses on the type of install needed
for ownCloud. %% That's not really useful, clarify!
.. You can make some pretty good educated guesses on the type of install needed for ownCloud. %% That's not really useful, clarify!
Take particular note of your MySQL password, as the user name ``root``
Take particular note of your MySQL password, as the user name **root**
and the password you select will be necessary alter on in the ownCloud
installation. As an aside, this link is an excellent resource for questions on
how to configure your MySQL instance, and also to configure PHP to work with
@@ -205,81 +170,62 @@ Installing ownCloud
1. Download the latest version of ownCloud from http://owncloud.org/download.
2. It will arrive as a tar.bz2 file, and I recommend something like jZip for a
free utility to unzip it.
2. It will arrive as a tar.bz2 file, and I recommend something like jZip for a free utility to unzip it.
3. Once you have the ownCloud directory unzipped and saved locally, copy it
into your wwwroot directory (probably ``c:\inetpub\wwwroot``).
3. Once you have the ownCloud directory unzipped and saved locally, copy it into your wwwroot directory (probably **C:\\inetpub\\wwwroot**).
..note:: You cannot install directly into the directory ``wwwroot`` from jzip,
as only the administrator can unzip into the ``wwwroot`` directory. If you save
it in a different folder, and then move the files into ``wwwroot`` in Windows
explorer, it works. This will install ownCloud locally in your root web
directory. You can use a subdirectory called owncloud, or whatever you want –
the www root, or something else.
..note:: You cannot install directly into the directory **wwwroot** from jzip, as only the administrator can unzip into the **wwwroot** directory. If you save it in a different folder, and then move the files into **wwwroot** in windows explorer, it works. This will install ownCloud locally in your root web directory. You can use a subdirectory called owncloud, or whatever you want – the www root, or something else.
4. It is now time to give write access to the ownCloud directory to the
ownCloud server: Navigate your windows explorer over to
``inetpub/wwwroot/owncloud`` (or your installation directory if you selected
something different).
4. It is now time to give write access to the ownCloud directory to the ownCloud server: Navigate your windows explorer over to **inetpub/wwwroot/owncloud** (or your installation directory if you selected something different).
5. Right click and select properties. Click on the security tab, and click the
button “to change permissions, click edit”.
5. Right click and select properties. Click on the security tab, and click the button “to change permissions, click edit”.
6. Select the “users” user from the list, and check the box “write”.
7. Apply these settings and close out.
8. Now open your browser and go to ``http://localhost/owncloud`` (or localhost
if it is installed in the root www directory). This should bring up the
ownCloud configuration page.
8. Now open your browser and go to http://localhost/owncloud (or localhost if it is installed in the root www directory). This should bring up the ownCloud configuration page.
9. At this page, you enter your desired ownCloud user name and password for the
administrator, and expand the little arrow.
9. At this page, you enter your desired ownCloud user name and password for the administrator, and expand the little arrow.
10. Select MySQL as the database, and enter your MySQL database user name,
password and desired instance name – use the user name and password you
setup for MySQL earlier in step 3, and pick any name for the database
instance.
10. Select MySQL as the database, and enter your MySQL database user name, password and desired instance name – use the user name and password you setup for MySQL earlier in step 3, and pick any name for the database instance.
..note:: The owncloud admin password and the MySQL password CANNOT be the same
in any way.
..note:: The owncloud admin password and the MySQL password CANNOT be the same in any way.
11. Click next, and ownCloud should have you logged in as the admin user, and
you can get started exploring ownCloud, creating other users and more!
11. Click next, and ownCloud should have you logged in as the admin user, and you can get started exploring ownCloud, creating other users and more!
Configuring ownCloud, PHP and IIS for Large File Uploads
Before going too nuts on ownCloud, it is important to do a couple of
configuration changes to make this a useful service for you. You will probably
want to increase the ``max upload size``, for example. The default upload is
set to ``2MB``, which is too small for even most MP3 files.
want to increase the **max upload size**, for example. The default upload is
set to **2MB**, which is too small for even most MP3 files.
To do that, simply go into your ``PHP.ini`` file, which can be found in your
``C:\Program Files (x86)\PHP`` folder. In here, you will find a ``PHP.ini```
To do that, simply go into your **PHP.ini** file, which can be found in your
**C:\\Program Files (x86)\\PHP** folder. In here, you will find a **PHP.ini**
file. Open this in a text editor, and look for a few key attributes to
change:
+``upload_max_filesize``– change this to something good, like 1G, and you
+**upload_max_filesize**– change this to something good, like 1G, and you
will get to upload much larger files.
+``post_max_size``– also change this size, and make it larger than the max
+**post_max_size**– also change this size, and make it larger than the max
upload size you chose, like 1G.
There are other changes you can make, such as the timeout duration for
uploads, but for now you should be all set in the ``PHP.ini`` file.
uploads, but for now you should be all set in the **PHP.ini** file.
Now you have to go back to IIS manager and make one last change to enable file
uploads on the web server larger than 30MB.
1. Go to the start menu, and type ``iis manager``.
1. Go to the start menu, and type **iis manager**.
2. Open IIS Manager Select the website you want enable to accept large file
uploads.
3. In the main window in the middle double click on the icon ``Request
filtering``.
3. In the main window in the middle double click on the icon **Request
filtering**.
4. Once the window is opened you will see a bunch of tabs across the top of the
far right,
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Bernhard Posselt