quota.html
13.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Storage Quota — ownCloud User Manual 7.0 documentation</title>
<link rel="stylesheet" href="../_static/style.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/style.css" type="text/css" />
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '7.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/bootstrap.js"></script>
<link rel="top" title="ownCloud User Manual 7.0 documentation" href="../index.html" />
<link rel="up" title="Files & Synchronization" href="index.html" />
<link rel="next" title="Managing Big Files" href="configuring_big_file_upload.html" />
<link rel="prev" title="Encrypting Files" href="encryption.html" />
<script type="text/javascript">
(function () {
/**
* Patch TOC list.
*
* Will mutate the underlying span to have a correct ul for nav.
*
* @param $span: Span containing nested UL's to mutate.
* @param minLevel: Starting level for nested lists. (1: global, 2: local).
*/
var patchToc = function ($ul, minLevel) {
var findA;
// Find all a "internal" tags, traversing recursively.
findA = function ($elem, level) {
var level = level || 0,
$items = $elem.find("> li > a.internal, > ul, > li > ul");
// Iterate everything in order.
$items.each(function (index, item) {
var $item = $(item),
tag = item.tagName.toLowerCase(),
pad = 15 + ((level - minLevel) * 10);
if (tag === 'a' && level >= minLevel) {
// Add to existing padding.
$item.css('padding-left', pad + "px");
console.log(level, $item, 'padding-left', pad + "px");
} else if (tag === 'ul') {
// Recurse.
findA($item, level + 1);
}
});
};
console.log("HERE");
findA($ul);
};
$(document).ready(function () {
// Add styling, structure to TOC's.
$(".dropdown-menu").each(function () {
$(this).find("ul").each(function (index, item){
var $item = $(item);
$item.addClass('unstyled');
});
$(this).find("li").each(function () {
$(this).parent().append(this);
});
});
// Patch in level.
patchToc($("ul.globaltoc"), 2);
patchToc($("ul.localtoc"), 2);
// Enable dropdown.
$('.dropdown-toggle').dropdown();
});
}());
</script>
</head>
<body>
<div class="container">
<div class="content">
<div class="page-header">
<h1><a href="../contents.html">ownCloud User Manual</a></h1>
</div>
<div class="row">
<div class="span3">
<div class="sidebar">
<div class="well">
<div class="menu-support-container">
<ul id="menu-support" class="menu">
<ul>
<li><a href="../contents.html">Overview</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 7.0 User Documentation</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../whats_new.html">New in ownCloud 7</a></li>
<li class="toctree-l1"><a class="reference internal" href="../webinterface.html">The ownCloud Web Interface</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Files & Synchronization</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="filesweb.html">Accessing your Files Using the Web Interface</a></li>
<li class="toctree-l2"><a class="reference internal" href="files.html">Accessing Files Using WebDAV</a></li>
<li class="toctree-l2"><a class="reference internal" href="versioncontrol.html">Version Control</a></li>
<li class="toctree-l2"><a class="reference internal" href="server_to_server_using.html">Using Server-to-Server Sharing</a></li>
<li class="toctree-l2"><a class="reference internal" href="deletedfiles.html">Managing Deleted Files</a></li>
<li class="toctree-l2"><a class="reference internal" href="sync.html">Desktop Synchronization</a></li>
<li class="toctree-l2"><a class="reference internal" href="encryption.html">Encrypting Files</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="">Storage Quota</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#checking-available-space">Checking Available Space</a></li>
<li class="toctree-l3"><a class="reference internal" href="#available-space-and-sharing">Available Space and Sharing</a></li>
<li class="toctree-l3"><a class="reference internal" href="#excluded-from-quota">Excluded from quota</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="configuring_big_file_upload.html">Managing Big Files</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../pim/index.html">Contacts & Calendar</a></li>
<li class="toctree-l1"><a class="reference internal" href="../bookmarks.html">Using the Bookmarks App</a></li>
<li class="toctree-l1"><a class="reference internal" href="../documents.html">Documents</a></li>
<li class="toctree-l1"><a class="reference internal" href="../migration.html">User Account Migration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../userpreferences.html">Changing Preferences</a></li>
<li class="toctree-l1"><a class="reference internal" href="../external_storage/google_drive.html">Configuring External Storage</a></li>
</ul>
</ul>
</div>
</div>
</div>
</div>
<div class="span9">
<div class="page-content">
<div class="section" id="storage-quota">
<h1>Storage Quota<a class="headerlink" href="#storage-quota" title="Permalink to this headline">¶</a></h1>
<p>ownCloud enables you to specify a storage quota for users which is the
<strong>maximum space</strong> a user is allowed to use for files located in their
individual home storage.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Quota settings <strong>only apply to actual files</strong>, not application
metadata. Application metadate consumes an added 10% of space for any given
user. When allocating quotas, you must ensure that there is at least 10% more
space available for each user.</p>
</div>
<div class="section" id="checking-available-space">
<h2>Checking Available Space<a class="headerlink" href="#checking-available-space" title="Permalink to this headline">¶</a></h2>
<p>You can check available space by accessing the “Personal Settings” page. To
access your personal settings:</p>
<ol class="arabic simple">
<li>Click the Personal Settings dropdown menu to the right of the Search field
in the ownCloud Main User Interface.</li>
</ol>
<blockquote>
<div><div class="figure">
<img alt="../_images/oc_personal_settings_dropdown.png" src="../_images/oc_personal_settings_dropdown.png" />
<p class="caption">Personal Settings menu</p>
</div>
</div></blockquote>
<ol class="arabic" start="2">
<li><dl class="first docutils">
<dt>Select “Personal” from the menu. The Personal Settings window opens.</dt>
<dd><div class="first last figure">
<img alt="../_images/oc_personal_settings_window.png" src="../_images/oc_personal_settings_window.png" />
</div>
</dd>
</dl>
</li>
</ol>
<p>The available space of a given user is calculated using the following formula:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">available_space</span> <span class="o">=</span> <span class="nb">min</span><span class="p">(</span><span class="n">quota</span><span class="p">,</span> <span class="n">disk_free_space</span><span class="p">)</span> <span class="o">-</span> <span class="n">used_space</span>
</pre></div>
</div>
<p><tt class="docutils literal"><span class="pre">disk_free_space</span></tt> is the space available on the partition on which the home
storage for a user is located on the server.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">It is possible that the available space on a partition is less than
the user quota.</p>
</div>
<div class="admonition-todo admonition" id="index-0">
<p class="first admonition-title">Todo</p>
<p class="last">??So what do we do in that case??</p>
</div>
</div>
<div class="section" id="available-space-and-sharing">
<h2>Available Space and Sharing<a class="headerlink" href="#available-space-and-sharing" title="Permalink to this headline">¶</a></h2>
<p>When sharing files or folders, the space that each file or folder (along with
the folder contents) uses is counted in the quota for the user who is sharing
the files or folders. For example:</p>
<p><strong>Example: Available Space and Shared Files</strong></p>
<p>If user ‘A’ shares a file with user ‘B,’ the size of the file is counted
against the storage quota for user ‘A’, even if the file is modified or its
size is increased by user ‘B.’‘</p>
<p><strong>Example: Available Space and Shared Folders</strong></p>
<p>If user ‘A’ shares a folder with user ‘B,’ the size of the folder (along with
its contents) is counted against the storage quota for user ‘A.’ This means
that any file that is modified or uploaded by user ‘B’ inside of the shared
folder counts against the storage quota for user ‘A.’</p>
<div class="section" id="resharing">
<h3>Resharing<a class="headerlink" href="#resharing" title="Permalink to this headline">¶</a></h3>
<p>When resharing a file or a directory, the used space is still counted in the
quota of the owner who shared it initially.</p>
</div>
<div class="section" id="public-sharing-with-upload-permission">
<h3>Public sharing with upload permission<a class="headerlink" href="#public-sharing-with-upload-permission" title="Permalink to this headline">¶</a></h3>
<p>If user A publicly shares (share with link) a directory D and enables the
“public upload” permission, people with the link will be able to upload files
into D and their sizes will be counted in user A’s used space.</p>
</div>
</div>
<div class="section" id="excluded-from-quota">
<h2>Excluded from quota<a class="headerlink" href="#excluded-from-quota" title="Permalink to this headline">¶</a></h2>
<div class="section" id="metadata-and-cache">
<h3>Metadata and cache<a class="headerlink" href="#metadata-and-cache" title="Permalink to this headline">¶</a></h3>
<p>Application metadata and cached information are excluded from the total used
space.</p>
<p>Such data could be thumbnails (icon previews, pictures app), temporary files,
encryption keys, etc.</p>
<p>Some apps are also storing information directly in the database (not as files)
like the <a class="reference internal" href="../pim/calendar.html"><em>calendar</em></a> and <a class="reference internal" href="../pim/contacts.html"><em>contacts</em></a> apps. This data is also excluded from the total used space.</p>
</div>
<div class="section" id="deleted-files">
<h3>Deleted files<a class="headerlink" href="#deleted-files" title="Permalink to this headline">¶</a></h3>
<p>When deleting files, these are moved/copied to the <a class="reference internal" href="deletedfiles.html"><em>trashbin</em></a> at first. These files do not count in the user’s used space.</p>
<p>For example with a quota of 10 GB, if the user has 4 GB used space and 5 GB in
the trashbin, they will still see 6 GB free space. If the user uploads 6 GB of
files at this point, the <a class="reference internal" href="deletedfiles.html"><em>trashbin app</em></a> will discard
deleted files when necessary to make room for the new files.</p>
</div>
<div class="section" id="version-control">
<h3>Version Control<a class="headerlink" href="#version-control" title="Permalink to this headline">¶</a></h3>
<p>The size of older file versions does not count in the used space.</p>
<p>For example with a quota of 10 GB, if the user has 4 GB used space and 5 GB of
older file versions, they will still see 6 GB free space. If the user uploads 6
GB of files at this point, the <a class="reference internal" href="versioncontrol.html"><em>versions app</em></a> will
discard older versions when necessary to make room for the new files.</p>
<p>See <a class="reference internal" href="versioncontrol.html"><em>Version Control</em></a> for details about the version expiration behavior.</p>
</div>
<div class="section" id="encryption">
<h3>Encryption<a class="headerlink" href="#encryption" title="Permalink to this headline">¶</a></h3>
<p>When files are <a class="reference internal" href="encryption.html"><em>encrypted</em></a>, they take slightly more physical
space than the original files. Only the original size will be counted in the
used space.</p>
</div>
<div class="section" id="external-storage">
<h3>External storage<a class="headerlink" href="#external-storage" title="Permalink to this headline">¶</a></h3>
<p>When mounting external storage, either as administrator or as user, the space
available on that storage is not taken into account for the user’s quota.
It is currently not possible to set a quota for external storage.</p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>