15308555518/ seafile-admin-docs
1
0
Fork 0
mirror of https://github.com/haiwen/seafile-admin-docs.git synced 2025-12-25 18:22:48 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Deployed 386aee59 to 13.0 with MkDocs 1.6.1 and mike 2.1.3

This commit is contained in:
ci-bot 2025-12-03 07:16:32 +00:00
parent 6476b49f36
commit e6e145bbd5
2 changed files with 92 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
13.0/search/search_index.json
View File

File diff suppressed because one or more lines are too long

144
13.0/upgrade/upgrade_notes_for_13.0.x/index.html
View File

@ -4471,10 +4471,10 @@
</li>
<li class="md-nav__item">
<a href="#new-system-libraries-to-be-updated" class="md-nav__link">
<a href="#new-system-libraries" class="md-nav__link">
<span class="md-ellipsis">
New system libraries (TO be updated)
New system libraries
</span>
</a>
@ -4482,10 +4482,10 @@
</li>
<li class="md-nav__item">
<a href="#new-python-libraries-to-be-updated" class="md-nav__link">
<a href="#new-python-libraries" class="md-nav__link">
<span class="md-ellipsis">
New Python libraries (TO be updated)
New Python libraries
</span>
</a>
@ -4527,10 +4527,10 @@
</li>
<li class="md-nav__item">
<a href="#3-stop-seafile-110x-server" class="md-nav__link">
<a href="#3-stop-seafile-120x-server" class="md-nav__link">
<span class="md-ellipsis">
3) Stop Seafile-11.0.x server
3) Stop Seafile-12.0.x server
</span>
</a>
@ -4538,10 +4538,10 @@
</li>
<li class="md-nav__item">
<a href="#4-run-seafile-120x-upgrade-script" class="md-nav__link">
<a href="#4-run-seafile-130x-upgrade-script" class="md-nav__link">
<span class="md-ellipsis">
4) Run Seafile 12.0.x upgrade script
4) Run Seafile 13.0.x upgrade script
</span>
</a>
@ -4549,10 +4549,10 @@
</li>
<li class="md-nav__item">
<a href="#5-create-the-env-file-in-conf-directory" class="md-nav__link">
<a href="#5-modify-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
5) Create the .env file in conf/ directory
5) Modify the .env file in conf/ directory
</span>
</a>
@ -4560,10 +4560,10 @@
</li>
<li class="md-nav__item">
<a href="#6-start-seafile-120x-server" class="md-nav__link">
<a href="#6-start-seafile-130x-server" class="md-nav__link">
<span class="md-ellipsis">
6) Start Seafile-12.0.x server
6) Start Seafile-13.0.x server
</span>
</a>
@ -5417,10 +5417,10 @@
</li>
<li class="md-nav__item">
<a href="#new-system-libraries-to-be-updated" class="md-nav__link">
<a href="#new-system-libraries" class="md-nav__link">
<span class="md-ellipsis">
New system libraries (TO be updated)
New system libraries
</span>
</a>
@ -5428,10 +5428,10 @@
</li>
<li class="md-nav__item">
<a href="#new-python-libraries-to-be-updated" class="md-nav__link">
<a href="#new-python-libraries" class="md-nav__link">
<span class="md-ellipsis">
New Python libraries (TO be updated)
New Python libraries
</span>
</a>
@ -5473,10 +5473,10 @@
</li>
<li class="md-nav__item">
<a href="#3-stop-seafile-110x-server" class="md-nav__link">
<a href="#3-stop-seafile-120x-server" class="md-nav__link">
<span class="md-ellipsis">
3) Stop Seafile-11.0.x server
3) Stop Seafile-12.0.x server
</span>
</a>
@ -5484,10 +5484,10 @@
</li>
<li class="md-nav__item">
<a href="#4-run-seafile-120x-upgrade-script" class="md-nav__link">
<a href="#4-run-seafile-130x-upgrade-script" class="md-nav__link">
<span class="md-ellipsis">
4) Run Seafile 12.0.x upgrade script
4) Run Seafile 13.0.x upgrade script
</span>
</a>
@ -5495,10 +5495,10 @@
</li>
<li class="md-nav__item">
<a href="#5-create-the-env-file-in-conf-directory" class="md-nav__link">
<a href="#5-modify-the-env-file-in-conf-directory" class="md-nav__link">
<span class="md-ellipsis">
5) Create the .env file in conf/ directory
5) Modify the .env file in conf/ directory
</span>
</a>
@ -5506,10 +5506,10 @@
</li>
<li class="md-nav__item">
<a href="#6-start-seafile-120x-server" class="md-nav__link">
<a href="#6-start-seafile-130x-server" class="md-nav__link">
<span class="md-ellipsis">
6) Start Seafile-12.0.x server
6) Start Seafile-13.0.x server
</span>
</a>
@ -5609,33 +5609,28 @@ Please always follow the main <a href="../upgrade/">upgrade guide</a>.</p>
<p>Deploying Seafile with binary package is no longer supported for community edition. We recommend you to migrate your existing Seafile deployment to docker based.</p>
<h3 id="elasticsearch-change-pro-edition-only">ElasticSearch change (pro edition only)<a class="headerlink" href="#elasticsearch-change-pro-edition-only" title="Permanent link">&para;</a></h3>
<p>Elasticsearch version is not changed in Seafile version 13.0</p>
<h2 id="new-system-libraries-to-be-updated">New system libraries (TO be updated)<a class="headerlink" href="#new-system-libraries-to-be-updated" title="Permanent link">&para;</a></h2>
<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Ubuntu 24.04/22.04</label><label for="__tabbed_1_2">Debian 11</label></div>
<h2 id="new-system-libraries">New system libraries<a class="headerlink" href="#new-system-libraries" title="Permanent link">&para;</a></h2>
<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">Ubuntu 24.04/22.04</label><label for="__tabbed_1_2">Debian 12/13</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>default-libmysqlclient-dev<span class="w"> </span>build-essential<span class="w"> </span>pkg-config<span class="w"> </span>libmemcached-dev
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>python3<span class="w"> </span>python3-dev<span class="w"> </span>python3-setuptools<span class="w"> </span>python3-pip<span class="w"> </span>python3-ldap<span class="w"> </span>python3-rados<span class="w"> </span>libmysqlclient-dev<span class="w"> </span>memcached<span class="w"> </span>libmemcached-dev<span class="w"> </span>redis-server<span class="w"> </span>libhiredis-dev<span class="w"> </span>ldap-utils<span class="w"> </span>libldap2-dev<span class="w"> </span>python3.12-venv<span class="w"> </span>default-libmysqlclient-dev<span class="w"> </span>build-essential<span class="w"> </span>pkg-config
</code></pre></div>
</div>
<div class="tabbed-block">
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>libsasl2-dev
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>python3<span class="w"> </span>python3-dev<span class="w"> </span>python3-setuptools<span class="w"> </span>python3-pip<span class="w"> </span>python3-ldap<span class="w"> </span>python3-rados<span class="w"> </span>libmariadb-dev-compat<span class="w"> </span>memcached<span class="w"> </span>libmemcached-dev<span class="w"> </span>redis-server<span class="w"> </span>libhiredis-dev<span class="w"> </span>ldap-utils<span class="w"> </span>libldap2-dev<span class="w"> </span>libsasl2-dev<span class="w"> </span>pkg-config<span class="w"> </span>python3.13-venv
</code></pre></div>
</div>
</div>
</div>
<h2 id="new-python-libraries-to-be-updated">New Python libraries (TO be updated)<a class="headerlink" href="#new-python-libraries-to-be-updated" title="Permanent link">&para;</a></h2>
<h2 id="new-python-libraries">New Python libraries<a class="headerlink" href="#new-python-libraries" title="Permanent link">&para;</a></h2>
<p>Note, you should install Python libraries system wide using root user or sudo mode.</p>
<div class="tabbed-set tabbed-alternate" data-tabs="2:2"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio" /><input id="__tabbed_2_2" name="__tabbed_2" type="radio" /><div class="tabbed-labels"><label for="__tabbed_2_1">Ubuntu 24.04 / Debian 12</label><label for="__tabbed_2_2">Ubuntu 22.04 / Debian 11</label></div>
<div class="tabbed-set tabbed-alternate" data-tabs="2:1"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio" /><div class="tabbed-labels"><label for="__tabbed_2_1">Ubuntu 24.04 / Debian 12</label></div>
<div class="tabbed-content">
<div class="tabbed-block">
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>pip3<span class="w"> </span>install<span class="w"> </span><span class="nv">future</span><span class="o">==</span><span class="m">1</span>.0.*<span class="w"> </span><span class="nv">mysqlclient</span><span class="o">==</span><span class="m">2</span>.2.*<span class="w"> </span><span class="nv">pillow</span><span class="o">==</span><span class="m">10</span>.4.*<span class="w"> </span><span class="nv">sqlalchemy</span><span class="o">==</span><span class="m">2</span>.0.*<span class="w"> </span><span class="nv">pillow_heif</span><span class="o">==</span><span class="m">0</span>.18.0<span class="w"> </span><span class="se">\</span>
<span class="nv">gevent</span><span class="o">==</span><span class="m">24</span>.2.*<span class="w"> </span><span class="nv">captcha</span><span class="o">==</span><span class="m">0</span>.6.*<span class="w"> </span><span class="nv">django_simple_captcha</span><span class="o">==</span><span class="m">0</span>.6.*<span class="w"> </span><span class="nv">djangosaml2</span><span class="o">==</span><span class="m">1</span>.9.*<span class="w"> </span><span class="se">\</span>
<span class="nv">pysaml2</span><span class="o">==</span><span class="m">7</span>.3.*<span class="w"> </span><span class="nv">pycryptodome</span><span class="o">==</span><span class="m">3</span>.20.*<span class="w"> </span><span class="nv">cffi</span><span class="o">==</span><span class="m">1</span>.17.0<span class="w"> </span>python-ldap<span class="o">==</span><span class="m">3</span>.4.*
</code></pre></div>
</div>
<div class="tabbed-block">
<div class="highlight"><pre><span></span><code>sudo<span class="w"> </span>pip3<span class="w"> </span>install<span class="w"> </span><span class="nv">future</span><span class="o">==</span><span class="m">1</span>.0.*<span class="w"> </span><span class="nv">mysqlclient</span><span class="o">==</span><span class="m">2</span>.1.*<span class="w"> </span><span class="nv">pillow</span><span class="o">==</span><span class="m">10</span>.4.*<span class="w"> </span><span class="nv">sqlalchemy</span><span class="o">==</span><span class="m">2</span>.0.*<span class="w"> </span><span class="nv">pillow_heif</span><span class="o">==</span><span class="m">0</span>.18.0<span class="w"> </span><span class="se">\</span>
<span class="nv">gevent</span><span class="o">==</span><span class="m">24</span>.2.*<span class="w"> </span><span class="nv">captcha</span><span class="o">==</span><span class="m">0</span>.6.*<span class="w"> </span><span class="nv">django_simple_captcha</span><span class="o">==</span><span class="m">0</span>.6.*<span class="w"> </span><span class="nv">djangosaml2</span><span class="o">==</span><span class="m">1</span>.9.*<span class="w"> </span><span class="se">\</span>
<span class="nv">pysaml2</span><span class="o">==</span><span class="m">7</span>.2.*<span class="w"> </span><span class="nv">pycryptodome</span><span class="o">==</span><span class="m">3</span>.16.*<span class="w"> </span><span class="nv">cffi</span><span class="o">==</span><span class="m">1</span>.15.1<span class="w"> </span>python-ldap<span class="o">==</span><span class="m">3</span>.2.0
<div class="highlight"><pre><span></span><code>pip3<span class="w"> </span>install<span class="w"> </span>--timeout<span class="o">=</span><span class="m">3600</span><span class="w"> </span>boto3<span class="w"> </span>oss2<span class="w"> </span>twilio<span class="w"> </span>configparser<span class="w"> </span>pytz<span class="w"> </span><span class="se">\</span>
<span class="nv">sqlalchemy</span><span class="o">==</span><span class="m">2</span>.0.*<span class="w"> </span><span class="nv">pymysql</span><span class="o">==</span><span class="m">1</span>.1.*<span class="w"> </span>jinja2<span class="w"> </span>django-pylibmc<span class="w"> </span>pylibmc<span class="w"> </span>redis<span class="w"> </span>django-redis<span class="w"> </span>psd-tools<span class="w"> </span>lxml<span class="w"> </span><span class="se">\</span>
<span class="nv">django</span><span class="o">==</span><span class="m">5</span>.2.*<span class="w"> </span><span class="nv">cffi</span><span class="o">==</span><span class="m">1</span>.17.1<span class="w"> </span><span class="nv">future</span><span class="o">==</span><span class="m">1</span>.0.*<span class="w"> </span><span class="nv">mysqlclient</span><span class="o">==</span><span class="m">2</span>.2.*<span class="w"> </span><span class="nv">captcha</span><span class="o">==</span><span class="m">0</span>.7.*<span class="w"> </span><span class="nv">django_simple_captcha</span><span class="o">==</span><span class="m">0</span>.6.*<span class="w"> </span><span class="se">\</span>
<span class="nv">pyjwt</span><span class="o">==</span><span class="m">2</span>.10.*<span class="w"> </span><span class="nv">djangosaml2</span><span class="o">==</span><span class="m">1</span>.11.*<span class="w"> </span><span class="nv">pysaml2</span><span class="o">==</span><span class="m">7</span>.5.*<span class="w"> </span><span class="nv">pycryptodome</span><span class="o">==</span><span class="m">3</span>.23.*<span class="w"> </span>python-ldap<span class="o">==</span><span class="m">3</span>.4.*<span class="w"> </span><span class="nv">pillow</span><span class="o">==</span><span class="m">11</span>.3.*<span class="w"> </span>pillow-heif<span class="o">==</span><span class="m">1</span>.0.*<span class="w"> </span><span class="nv">cairosvg</span><span class="o">==</span><span class="m">2</span>.8.*
</code></pre></div>
</div>
</div>
@ -5646,44 +5641,87 @@ Please always follow the main <a href="../upgrade/">upgrade guide</a>.</p>
<p>If you have a large number of <code>Activity</code> in MySQL, clear this table first <a href="../../administration/clean_database">Clean Database</a>. Otherwise, the database upgrade will take a long time.</p>
<h3 id="2-install-new-system-libraries-and-python-libraries">2) Install new system libraries and Python libraries<a class="headerlink" href="#2-install-new-system-libraries-and-python-libraries" title="Permanent link">&para;</a></h3>
<p>Install new system libraries and Python libraries for your operation system as documented above.</p>
<h3 id="3-stop-seafile-110x-server">3) Stop Seafile-11.0.x server<a class="headerlink" href="#3-stop-seafile-110x-server" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 11.0.x, run the commands:</p>
<div class="highlight"><pre><span></span><code>./seahub.sh<span class="w"> </span>stop
./seafile.sh<span class="w"> </span>stop
<h3 id="3-stop-seafile-120x-server">3) Stop Seafile-12.0.x server<a class="headerlink" href="#3-stop-seafile-120x-server" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 12.0.x, run the commands:</p>
<div class="highlight"><pre><span></span><code>./seafile.sh<span class="w"> </span>stop
./seahub.sh<span class="w"> </span>stop
</code></pre></div>
<h3 id="4-run-seafile-120x-upgrade-script">4) Run Seafile 12.0.x upgrade script<a class="headerlink" href="#4-run-seafile-120x-upgrade-script" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 12.0.x, run the upgrade script</p>
<div class="highlight"><pre><span></span><code>upgrade/upgrade_11.0_12.0.sh
<h3 id="4-run-seafile-130x-upgrade-script">4) Run Seafile 13.0.x upgrade script<a class="headerlink" href="#4-run-seafile-130x-upgrade-script" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 13.0.x, run the upgrade script</p>
<div class="highlight"><pre><span></span><code>upgrade/upgrade_12.0_13.0.sh
</code></pre></div>
<h3 id="5-create-the-env-file-in-conf-directory">5) Create the <code>.env</code> file in <code>conf/</code> directory<a class="headerlink" href="#5-create-the-env-file-in-conf-directory" title="Permanent link">&para;</a></h3>
<h3 id="5-modify-the-env-file-in-conf-directory">5) Modify the <code>.env</code> file in <code>conf/</code> directory<a class="headerlink" href="#5-modify-the-env-file-in-conf-directory" title="Permanent link">&para;</a></h3>
<p>conf/.env</p>
<div class="highlight"><pre><span></span><code>TIME_ZONE=UTC
JWT_PRIVATE_KEY=xxx
<div class="highlight"><pre><span></span><code>IS_PRO_VERSION=true
JWT_PRIVATE_KEY=&lt;Your jwt private key&gt;
SEAFILE_SERVER_PROTOCOL=https
SEAFILE_SERVER_HOSTNAME=seafile.example.com
SEAFILE_MYSQL_DB_HOST=db # your MySQL host
SEAFILE_MYSQL_DB_HOST=&lt;your database host&gt;
SEAFILE_MYSQL_DB_PORT=3306
SEAFILE_MYSQL_DB_USER=seafile
SEAFILE_MYSQL_DB_PASSWORD=&lt;your MySQL password&gt;
SEAFILE_MYSQL_DB_CCNET_DB_NAME=ccnet_db
SEAFILE_MYSQL_DB_SEAFILE_DB_NAME=seafile_db
SEAFILE_MYSQL_DB_SEAHUB_DB_NAME=seahub_db
## Cache
CACHE_PROVIDER=redis # options: redis (recommend), memcached
### Redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=
### Memcached
MEMCACHED_HOST=memcached
MEMCACHED_PORT=11211
</code></pre></div>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>Redis is recommended as the cache server, you need to install the following dependencies.</p>
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>redis-server<span class="w"> </span>libhiredis-dev
<span class="c1"># activate the venv</span>
<span class="nb">source</span><span class="w"> </span>python-venv/bin/activate
pip3<span class="w"> </span>install<span class="w"> </span>redis<span class="w"> </span>django-redis
systemctl<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>--now<span class="w"> </span>redis-server
</code></pre></div>
<p>If you are using memcached as the cache server, you need to install the following dependencies.</p>
<div class="highlight"><pre><span></span><code>apt-get<span class="w"> </span>install<span class="w"> </span>memcached<span class="w"> </span>libmemcached-dev<span class="w"> </span>-y
<span class="c1"># activate the venv</span>
<span class="nb">source</span><span class="w"> </span>python-venv/bin/activate
pip3<span class="w"> </span>install<span class="w"> </span>pylibmc<span class="w"> </span>django-pylibmc
systemctl<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>--now<span class="w"> </span>memcached
</code></pre></div>
</div>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>JWT_PRIVATE_KEY, A random string with a length of no less than 32 characters, can be generated by</p>
<div class="highlight"><pre><span></span><code>pwgen<span class="w"> </span>-s<span class="w"> </span><span class="m">40</span><span class="w"> </span><span class="m">1</span>
</code></pre></div>
</div>
<h3 id="6-start-seafile-120x-server">6) Start Seafile-12.0.x server<a class="headerlink" href="#6-start-seafile-120x-server" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 12.0.x, run the command:</p>
<h3 id="6-start-seafile-130x-server">6) Start Seafile-13.0.x server<a class="headerlink" href="#6-start-seafile-130x-server" title="Permanent link">&para;</a></h3>
<p>In the folder of Seafile 13.0.x, run the command:</p>
<div class="highlight"><pre><span></span><code>./seafile.sh start # starts seaf-server
./seahub.sh start # starts seahub
</code></pre></div>
<h3 id="7-optional-upgrade-notification-server">7) (Optional) Upgrade notification server<a class="headerlink" href="#7-optional-upgrade-notification-server" title="Permanent link">&para;</a></h3>
<p>Since seafile 12.0, we use docker to deploy the notification server. Please follow the document of <a href="../../extension/notification-server/">notification server</a> to re-deploy notification server.</p>
<div class="admonition note notification server and seafile binary package">
<p class="admonition-title">Note</p>
<p>Notification server is designed to be work with Docker based deployment. To make it work with <strong>Seafile binary package</strong> on the same server, you will need to add Nginx rules for notification server properly.</p>
</div>
<h3 id="8-optional-upgrade-seadoc-from-10-to-20">8) (Optional) Upgrade SeaDoc from 1.0 to 2.0<a class="headerlink" href="#8-optional-upgrade-seadoc-from-10-to-20" title="Permanent link">&para;</a></h3>
<p>Since seafile 12.0, we use docker to deploy the seadoc server. Please see the document <a href="../../extension/setup_seadoc/">Setup SeaDoc</a> to install SeaDoc on a separate machine and integrate with your binary packaged based Seafile server v13.0.</p>
<div class="admonition note">
<p class="admonition-title">SeaDoc and Seafile binary package</p>
<p>Deploying SeaDoc and <strong>Seafile binary package</strong> on the same server is no longer officially supported. You will need to add Nginx rules for SeaDoc server properly.</p>
</div>
<h2 id="faq">FAQ<a class="headerlink" href="#faq" title="Permanent link">&para;</a></h2>
<p>We have documented common issues encountered by users when upgrading to version 12.0 in our FAQ <a href="https://cloud.seatable.io/dtable/external-links/7b976c85f504491cbe8e/?tid=0000&amp;vid=0000">https://cloud.seatable.io/dtable/external-links/7b976c85f504491cbe8e/?tid=0000&amp;vid=0000</a>.</p>
<p>We have documented common issues encountered by users when upgrading to version 13.0 in our FAQ <a href="https://cloud.seatable.io/dtable/external-links/7b976c85f504491cbe8e/?tid=0000&amp;vid=0000">https://cloud.seatable.io/dtable/external-links/7b976c85f504491cbe8e/?tid=0000&amp;vid=0000</a>.</p>
<p>If you encounter any issue, please give it a check.</p>