Seafile

https://manual.seafile.com/latest/
Admin
Seafile is an open source cloud storage system for file sync, share, and document collaboration with...
Tokens:224,241
Snippets:2,949
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Verify Seafile Startup Logs

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_k8s?q=

Example output indicating that the Seafile server and Seahub have started successfully.

```text
*** Running /etc/my_init.d/01_create_data_links.sh...
*** Booting runit daemon...
*** Runit started as PID 20
*** Running /scripts/enterpoint.sh...
2024-11-21 03:02:35 Nginx ready 

2024-11-21 03:02:35 This is an idle script (infinite loop) to keep container running. 
---------------------------------

Seafile cluster frontend mode

---------------------------------


Starting seafile server, please wait ...
Seafile server started

Done.

Starting seahub at port 8000 ...

Seahub is started

Done.
```

--------------------------------

### Run Seafile Pro Setup Script

Source: https://manual.seafile.com/latest/setup_binary/installation

Navigate to the Seafile Pro server directory and execute the setup script for MySQL installations. This script automates the initial setup process.

```bash
cd seafile-pro-server-13.0.10
./setup-seafile-mysql.sh
```

--------------------------------

### Configure Multi-LDAP Server Setup (Example)

Source: https://manual.seafile.com/latest/config/ldap_in_pro

Enable multi-LDAP support with ENABLE_MULTI_LDAP = True and configure individual servers using MULTI_LDAP_1_* settings. This allows Seafile to query multiple LDAP servers sequentially.

```python
# Basic config options
ENABLE_LDAP = True
......

# Multi ldap config options
ENABLE_MULTI_LDAP = True
MULTI_LDAP_1_SERVER_URL = 'ldap://192.168.0.2'
MULTI_LDAP_1_BASE_DN = 'ou=test,dc=seafile,dc=top'
MULTI_LDAP_1_ADMIN_DN = 'administrator@example.top'
MULTI_LDAP_1_ADMIN_PASSWORD = 'Hello@123'
MULTI_LDAP_1_PROVIDER = 'ldap1'
MULTI_LDAP_1_LOGIN_ATTR = 'userPrincipalName'

# Optional configs
MULTI_LDAP_1_USER_FIRST_NAME_ATTR = 'givenName'
MULTI_LDAP_1_USER_LAST_NAME_ATTR = 'sn'
MULTI_LDAP_1_USER_NAME_REVERSE = False
ENABLE_MULTI_LDAP_1_EXTRA_USER_INFO_SYNC = True

MULTI_LDAP_1_FILTER = 'memberOf=CN=testgroup,OU=test,DC=seafile,DC=ren'
MULTI_LDAP_1_USE_PAGED_RESULT = False
MULTI_LDAP_1_FOLLOW_REFERRALS = True
ENABLE_MULTI_LDAP_1_USER_SYNC = True
ENABLE_MULTI_LDAP_1_GROUP_SYNC = True
MULTI_LDAP_1_SYNC_DEPARTMENT_FROM_OU = True

MULTI_LDAP_1_USER_OBJECT_CLASS = 'person'
MULTI_LDAP_1_DEPT_ATTR = ''
MULTI_LDAP_1_UID_ATTR = ''
MULTI_LDAP_1_CONTACT_EMAIL_ATTR = ''
MULTI_LDAP_1_USER_ROLE_ATTR = ''
MULTI_LDAP_1_AUTO_REACTIVATE_USERS = True

MULTI_LDAP_1_GROUP_OBJECT_CLASS = 'group'
MULTI_LDAP_1_GROUP_FILTER = ''
MULTI_LDAP_1_GROUP_MEMBER_ATTR = 'member'
MULTI_LDAP_1_GROUP_UUID_ATTR = 'objectGUID'
MULTI_LDAP_1_CREATE_DEPARTMENT_LIBRARY = False
MULTI_LDAP_1_DEPT_REPO_PERM = 'rw'
MULTI_LDAP_1_DEFAULT_DEPARTMENT_QUOTA = -2
MULTI_LDAP_1_SYNC_GROUP_AS_DEPARTMENT = False
MULTI_LDAP_1_USE_GROUP_MEMBER_RANGE_QUERY = False
MULTI_LDAP_1_USER_ATTR_IN_MEMBERUID = 'uid'
MULTI_LDAP_1_DEPT_NAME_ATTR = ''
......
```

--------------------------------

### Apply seaf-fuse start options

Source: https://manual.seafile.com/latest/extension/fuse?q=

Examples of passing mount options and disabling block cache for Pro edition.

```bash
./seaf-fuse.sh start -o uid=<uid> /data/seafile-fuse
```

```bash
./seaf-fuse.sh start --disable-block-cache /data/seafile-fuse
```

--------------------------------

### Install Nginx

Source: https://manual.seafile.com/latest/setup_binary/https_with_nginx?q=

Installs Nginx using the apt package manager. Ensure Nginx starts on system boot.

```bash
sudo apt install nginx -y

```

```bash
sudo systemctl start nginx
sudo systemctl enable nginx

```

--------------------------------

### Build and install libsearpc

Source: https://manual.seafile.com/latest/develop/linux?q=

Compiles and installs the libsearpc component.

```bash
cd libsearpc
./autogen.sh
./configure --prefix=$PREFIX
make
sudo make install
cd ..
```

--------------------------------

### Compile and Install Seafile Server Components

Source: https://manual.seafile.com/latest/develop/server?q=

Builds and installs libevhtp, libsearpc, and seafile-server from source.

```bash
cd ../libevhtp
cmake -DEVHTP_DISABLE_SSL=ON -DEVHTP_BUILD_SHARED=OFF .
make
make install
ldconfig

cd ../libsearpc
./autogen.sh
./configure
make
make install
ldconfig

cd ../seafile-server
./autogen.sh
./configure --disable-fuse
make
make install
ldconfig

```

--------------------------------

### Configure seaf-fuse start options

Source: https://manual.seafile.com/latest/extension/fuse

Examples for setting ownership or disabling block caching in Pro edition.

```bash
./seaf-fuse.sh start -o uid=<uid> /data/seafile-fuse
```

```bash
./seaf-fuse.sh start --disable-block-cache /data/seafile-fuse
```

--------------------------------

### Install Redis Server and Client Libraries

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_13.0.x

Installs Redis server and client libraries on Debian/Ubuntu systems. This is recommended for Seafile's cache provider. Includes enabling and starting the Redis service.

```bash
apt-get install -y redis-server libhiredis-dev

# activate the venv
source python-venv/bin/activate
pip3 install redis django-redis

systemctl enable --now redis-server

```

--------------------------------

### Install and configure MariaDB

Source: https://manual.seafile.com/latest/develop/server

Install the database server and set the root password.

```bash
apt-get install -y mariadb-server
service mariadb start
mysqladmin -u root password your_password
```

--------------------------------

### Initialize Seafile Environment

Source: https://manual.seafile.com/latest/setup_binary/installation

Installs system-level dependencies, creates the installation directory, and sets up a Python virtual environment.

```bash
sudo apt-get install -y python3 python3-dev python3-setuptools python3-pip python3-ldap python3-rados libmariadb-dev-compat libmemcached-dev ldap-utils libldap2-dev libsasl2-dev pkg-config python3.11-venv 

mkdir /opt/seafile
cd /opt/seafile

# create the vitual environment in the python-venv directory
python3 -m venv python-venv

# activate the venv
source python-venv/bin/activate
```

--------------------------------

### Build and install seafile-client

Source: https://manual.seafile.com/latest/develop/linux?q=

Compiles and installs the seafile-client using CMake.

```bash
cd seafile-client
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$PREFIX .
make
sudo make install
cd ..
```

--------------------------------

### Compile and install seaf-server components

Source: https://manual.seafile.com/latest/develop/server

Build and install the core Seafile components from source.

```bash
cd ../libevhtp
cmake -DEVHTP_DISABLE_SSL=ON -DEVHTP_BUILD_SHARED=OFF .
make
make install
ldconfig

cd ../libsearpc
./autogen.sh
./configure
make
make install
ldconfig

cd ../seafile-server
./autogen.sh
./configure --disable-fuse
make
make install
ldconfig
```

--------------------------------

### Install Node.js

Source: https://manual.seafile.com/latest/develop/server

Install Node 20 from the Nodesource repository.

```bash
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
apt-get install -y nodejs
```

--------------------------------

### Enable and Start Services

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_docker

Enables and starts the HAproxy and Keepalived services on both frontend servers.

```bash
$ systemctl enable --now haproxy
$ systemctl enable --now keepalived
```

--------------------------------

### Install dependencies and enable memcached

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_13.0.x

Activate the virtual environment, install required Python packages, and enable the memcached service.

```bash
source python-venv/bin/activate
pip3 install pylibmc django-pylibmc

systemctl enable --now memcached
```

--------------------------------

### Install and configure Redis

Source: https://manual.seafile.com/latest/setup_binary/installation

Commands to install Redis and configure the environment for Seafile.

```bash
# on Debian/Ubuntu 18.04+
apt-get install -y redis-server libhiredis-dev

# activate the venv
source python-venv/bin/activate
pip3 install redis django-redis

systemctl enable --now redis-server
```

```text
## Cache
CACHE_PROVIDER=redis

### Redis
REDIS_HOST='<your redis host>'
REDIS_PORT=6379
REDIS_PASSWORD=
```

--------------------------------

### Build and Install Seafile

Source: https://manual.seafile.com/latest/develop/linux

Compiles and installs the Seafile server components. The `--enable-ws=yes` flag enables the notification server.

```bash
cd seafile
./autogen.sh
./configure --prefix=$PREFIX --enable-ws=yes
make
sudo make install
cd ..

```

--------------------------------

### Start Seafile Services

Source: https://manual.seafile.com/latest/upgrade/upgrade_a_cluster_binary

Commands to start Seafile services on frontend and backend nodes.

```bash
cd /opt/seafile/seafile-server-latest
su seafile
./seafile.sh start
./seahub.sh start
```

```bash
cd /opt/seafile/seafile-server-latest
su seafile
./seafile.sh start
./seafile-background-tasks.sh start
```

--------------------------------

### Start Seafile Server

Source: https://manual.seafile.com/latest/setup/setup_ce_by_docker

Commands to initialize and start the Seafile service using Docker Compose.

```bash
docker compose up -d
```

```bash
docker compose --env-file /path/to/.env up -d
```

--------------------------------

### Install base system dependencies

Source: https://manual.seafile.com/latest/develop/server?q=

Updates the container and installs required development libraries and tools.

```bash
apt-get update && apt-get upgrade -y

apt-get install -y ssh libevent-dev libcurl4-openssl-dev libglib2.0-dev uuid-dev intltool libsqlite3-dev libmysqlclient-dev libarchive-dev libtool libjansson-dev valac libfuse-dev python3-dateutil cmake re2c flex sqlite3 python3-pip python3-simplejson git libssl-dev libldap2-dev libonig-dev vim vim-scripts wget cmake gcc autoconf automake mysql-client librados-dev libxml2-dev curl sudo telnet netcat unzip netbase ca-certificates apt-transport-https build-essential libxslt1-dev libffi-dev libpcre3-dev libz-dev xz-utils nginx pkg-config poppler-utils libmemcached-dev sudo ldap-utils libldap2-dev libjwt-dev libunwind-dev libhiredis-dev google-perftools libgoogle-perftools-dev
```

--------------------------------

### Install Redis Server and Development Libraries

Source: https://manual.seafile.com/latest/setup_binary/installation

Installs the Redis server and its development libraries using apt-get. This is a prerequisite for Seafile.

```bash
sudo apt-get update
sudo apt-get install -y redis-server libhiredis-dev

```

--------------------------------

### Start Seafile and Seahub services

Source: https://manual.seafile.com/latest/setup_binary/installation

Commands to activate the virtual environment and start the Seafile server components.

```bash
source python-venv/bin/activate
```

```bash
su seafile
./seafile.sh start # Start Seafile service
./seahub.sh start  # Start seahub website, port defaults to 127.0.0.1:8000
```

--------------------------------

### Start Frontend Node Services

Source: https://manual.seafile.com/latest/setup_binary/cluster_deployment?q=

Commands to start the Seafile and Seahub services on a frontend node.

```bash
cd /opt/seafile/seafile-server-latest
su seafile
./seafile.sh start
./seahub.sh start
```

--------------------------------

### Install Redis server

Source: https://manual.seafile.com/latest/setup_binary/installation?q=

Installs the Redis cache server and development headers required for Seafile.

```bash
sudo apt-get update
sudo apt-get install -y redis-server libhiredis-dev
```

--------------------------------

### OnlyOffice Custom Configuration Example

Source: https://manual.seafile.com/latest/extension/only_office?q=

Example JSON configuration to enable auto-assembly and set converter limits.

```json
{
  "services": {
    "CoAuthoring": {
      "autoAssembly": {
        "enable": true,
        "interval": "5m"
      }
    }
  },
  "FileConverter": {
    "converter": {
      "downloadAttemptMaxCount": 3
    }
  }
}
```

--------------------------------

### Verify Seafile Initialization Logs

Source: https://manual.seafile.com/latest/setup/setup_ce_by_docker?q=

Example output showing the configuration and database table creation process during the first startup.

```text
---------------------------------
This is your configuration
---------------------------------

    server name:            seafile
    server ip/domain:       seafile.example.com

    seafile data dir:       /opt/seafile/seafile-data
    fileserver port:        8082

    database:               create new
    ccnet database:         ccnet_db
    seafile database:       seafile_db
    seahub database:        seahub_db
    database user:          seafile


Generating seafile configuration ...

done
Generating seahub configuration ...

----------------------------------------
Now creating seafevents database tables ...

----------------------------------------
----------------------------------------
Now creating ccnet database tables ...

----------------------------------------
----------------------------------------
Now creating seafile database tables ...

----------------------------------------
----------------------------------------
Now creating seahub database tables ...

----------------------------------------

creating seafile-server-latest symbolic link ...  done

-----------------------------------------------------------------
Your seafile server configuration has been finished successfully.
-----------------------------------------------------------------
```

--------------------------------

### Install SAML prerequisites on Ubuntu

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_11.0.x?q=

Install required system packages for SAML functionality on Ubuntu 20.04 or 22.04.

```bash
sudo apt-get update
sudo apt-get install -y dnsutils
```

--------------------------------

### Initialize Seafile Directory and Configuration Files

Source: https://manual.seafile.com/latest/setup/setup_pro_by_docker?q=

Create the base directory and download the required configuration files for the Seafile Docker deployment.

```bash
mkdir /opt/seafile
cd /opt/seafile

wget -O .env https://manual.seafile.com/13.0/repo/docker/pro/env
wget https://manual.seafile.com/13.0/repo/docker/pro/seafile-server.yml
wget https://manual.seafile.com/13.0/repo/docker/pro/elasticsearch.yml
wget https://manual.seafile.com/13.0/repo/docker/seadoc.yml
wget https://manual.seafile.com/13.0/repo/docker/caddy.yml

nano .env
```

--------------------------------

### AWS S3 Backend Configuration Example

Source: https://manual.seafile.com/latest/setup/setup_with_s3

Example configuration for AWS S3, specifying the region and using v4 signature. This setup requires three distinct backend configurations for commit, fs, and block objects.

```ini
[commit_object_backend]
name = s3
bucket = my-commit-objects
key_id = your-key-id
key = your-secret-key
use_v4_signature = true
aws_region = eu-central-1
use_https = true

[fs_object_backend]
name = s3
bucket = my-fs-objects
key_id = your-key-id
key = your-secret-key
use_v4_signature = true
aws_region = eu-central-1
use_https = true

[block_backend]
name = s3
bucket = my-block-objects
key_id = your-key-id
key = your-secret-key
use_v4_signature = true
aws_region = eu-central-1
use_https = true

```

--------------------------------

### Create 7.x Compatible Indexes

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_9.0.x

Initialize the new indexes with the required mappings and settings.

```bash
curl -X PUT -H 'Content-Type: application/json' 'http{s}://{es server IP}:9200/new_repo_head?include_type_name=false&pretty=true' -d '
{
  "mappings" : {
    "properties" : {
      "commit" : {
        "type" : "text",
        "index" : false
      },
      "repo" : {
        "type" : "text",
        "index" : false
      },
      "updatingto" : {
        "type" : "text",
        "index" : false
      }
    }
  }
}'

curl -X PUT -H 'Content-Type: application/json' 'http{s}://{es server IP}:9200/new_repofiles/?include_type_name=false&pretty=true' -d '
{
  "settings" : {
    "index" : {
      "number_of_shards" : 5,
      "number_of_replicas" : 1,
      "analysis" : {
        "analyzer" : {
          "seafile_file_name_ngram_analyzer" : {
            "filter" : [
              "lowercase"
            ],
            "type" : "custom",
            "tokenizer" : "seafile_file_name_ngram_tokenizer"
          }
        },
        "tokenizer" : {
          "seafile_file_name_ngram_tokenizer" : {
            "type" : "ngram",
            "min_gram" : "3",
            "max_gram" : "4"
          }
        }
      }
    }
  },
  "mappings" : {
    "properties" : {
      "content" : {
        "type" : "text",
        "term_vector" : "with_positions_offsets"
      },
      "filename" : {
        "type" : "text",
        "fields" : {
          "ngram" : {
            "type" : "text",
            "analyzer" : "seafile_file_name_ngram_analyzer"
          }
        }
      },
      "is_dir" : {
        "type" : "boolean"
      },
      "mtime" : {
        "type" : "date"
      },
      "path" : {
        "type" : "keyword"
      },
      "repo" : {
        "type" : "keyword"
      },
      "size" : {
        "type" : "long"
      },
      "suffix" : {
        "type" : "keyword"
      }
    }
  }
}'
```

--------------------------------

### Download Configuration Files

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_docker

Fetch the required environment and compose files for the cluster setup.

```bash
wget -O .env https://manual.seafile.com/13.0/repo/docker/cluster/env
wget https://manual.seafile.com/13.0/repo/docker/cluster/seafile-server.yml
```

--------------------------------

### Run Elasticsearch Docker Container

Source: https://manual.seafile.com/latest/setup_binary/installation

Starts the Elasticsearch container in detached mode, mapping port 9200, configuring it as a single node, enabling memory locking, disabling security for initial setup, and setting up persistent storage. The container will restart automatically if it stops.

```bash
sudo docker run -d \
--name es \
-p 9200:9200 \
-e "discovery.type=single-node" -e "bootstrap.memory_lock=true" \
-e "ES_JAVA_OPTS=-Xms2g -Xmx2g" -e "xpack.security.enabled=false" \
--restart=always \
-v /opt/seafile-elasticsearch/data:/usr/share/elasticsearch/data \
-d elasticsearch:8.15.0

```

--------------------------------

### Custom User Search Function

Source: https://manual.seafile.com/latest/config/seahub_settings_py

Defines a custom function to modify user search results, for example, to limit searches to users within the same institution. This function must be placed in `{seafile install path}/conf/seahub_custom_functions/__init__.py` and named `custom_search_user`. Requires Seafile version 6.2 or later.

```python
import os
import sys

current_path = os.path.dirname(os.path.abspath(__file__))
seahub_dir = os.path.join(current_path, \
        '../../seafile-server-latest/seahub/seahub')
sys.path.append(seahub_dir)

from seahub.profile.models import Profile
def custom_search_user(request, emails):

    institution_name = ''

    username = request.user.username
    profile = Profile.objects.get_profile_by_user(username)
    if profile:
        institution_name = profile.institution

    inst_users = [p.user for p in
            Profile.objects.filter(institution=institution_name)]

    filtered_emails = []
    for email in emails:
        if email in inst_users:
            filtered_emails.append(email)

    return filtered_emails

```

--------------------------------

### Install xmlsec1 Package

Source: https://manual.seafile.com/latest/config/saml2

Install the xmlsec1 package for binary deployments. This is not needed for Docker deployments. Also installs dnsutils for multi-tenancy.

```bash
apt update
apt install xmlsec1
apt install dnsutils  # For multi-tenancy feature
```

--------------------------------

### Example .env configuration content

Source: https://manual.seafile.com/latest/setup_binary/installation

Template for the .env file including database, protocol, and cache settings.

```text
JWT_PRIVATE_KEY=<Your jwt private key>
SEAFILE_SERVER_PROTOCOL=https
SEAFILE_SERVER_HOSTNAME=seafile.example.com
SEAFILE_MYSQL_DB_HOST=<your database host>
SEAFILE_MYSQL_DB_PORT=3306
SEAFILE_MYSQL_DB_USER=seafile
SEAFILE_MYSQL_DB_PASSWORD=<your MySQL password>
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
### options: redis (recommend), memcached
CACHE_PROVIDER=redis

### Redis
REDIS_HOST='<your redis host>'
REDIS_PORT=6379
REDIS_PASSWORD=

### Memcached
MEMCACHED_HOST='<your memcached host>'
MEMCACHED_PORT=11211
```

--------------------------------

### Enable and Start Memcached Service

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_13.0.x?q=

Enable the memcached service to start automatically on boot and start it immediately. This is often required for caching in Seafile.

```bash
systemctl enable --now memcached
```

--------------------------------

### Install System Libraries for Ubuntu/Debian

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x?q=

Installs necessary system libraries for Seafile on Ubuntu 24.04/22.04 and Debian 11. Ensure these are installed before proceeding with the upgrade.

```bash
apt-get install -y default-libmysqlclient-dev build-essential pkg-config libmemcached-dev

```

```bash
apt-get install -y libsasl2-dev

```

--------------------------------

### Download and Edit Configuration

Source: https://manual.seafile.com/latest/setup/helm_chart_single_node

Fetch the default values file and open it for customization.

```bash
wget -O my-values.yaml https://haiwen.github.io/seafile-helm-chart/values/13.0/pro.yaml

nano my-values.yaml
```

```bash
wget -O my-values.yaml https://haiwen.github.io/seafile-helm-chart/values/13.0/ce.yaml

nano my-values.yaml
```

--------------------------------

### Install System Libraries (Ubuntu/Debian)

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x

Installs necessary system libraries for Seafile on Ubuntu 24.04/22.04 and Debian 11. Ensure these are installed before proceeding with the upgrade.

```bash
apt-get install -y default-libmysqlclient-dev build-essential pkg-config libmemcached-dev
```

```bash
apt-get install -y libsasl2-dev
```

--------------------------------

### Install Python Development Headers and Libraries

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_11.0.x

On Ubuntu 20.04/22.04, install necessary Python development headers and LDAP libraries before installing Python packages.

```bash
sudo apt-get update
sudo apt-get install -y python3-dev ldap-utils libldap2-dev

```

--------------------------------

### Seafile backend initialization log output

Source: https://manual.seafile.com/latest/setup/helm_chart_cluster?q=

Example output showing successful initialization of the Seafile backend container.

```text
Defaulted container "seafile-backend" out of: seafile-backend, set-ownership (init)
*** Running /etc/my_init.d/01_create_data_links.sh...
*** Booting runit daemon...
*** Runit started as PID 15
*** Running /scripts/enterpoint.sh...
2025-02-13 08:58:35 Nginx ready 
2025-02-13 08:58:35 This is an idle script (infinite loop) to keep container running. 

---------------------------------

Seafile cluster backend mode

---------------------------------

[2025-02-13 08:58:35] Now running setup-seafile-mysql.py in auto mode.
Checking python on this machine ...


verifying password of user root ...  done

---------------------------------
This is your configuration
---------------------------------

    server name:            seafile
    server ip/domain:       10.0.0.138

    seafile data dir:       /opt/seafile/seafile-data
    fileserver port:        8082

    database:               create new
    ccnet database:         ccnet_db
    seafile database:       seafile_db
    seahub database:        seahub_db
    database user:          seafile


Generating seafile configuration ...

done
Generating seahub configuration ...

----------------------------------------
Now creating seafevents database tables ...

----------------------------------------
----------------------------------------
Now creating ccnet database tables ...

----------------------------------------
----------------------------------------
Now creating seafile database tables ...

----------------------------------------
----------------------------------------
Now creating seahub database tables ...

----------------------------------------


-----------------------------------------------------------------
Your seafile server configuration has been finished successfully.
-----------------------------------------------------------------


[2025-02-13 08:58:36] Updating version stamp
Start init

Init success
```

--------------------------------

### Configure Local Filesystem Backend

Source: https://manual.seafile.com/latest/setup/migrate_backends_data?q=

Example configuration for migrating data to a local filesystem backend.

```ini
# ... other configurations

[commit_object_backend]
name = fs
dir = /var/data_backup

[fs_object_backend]
name = fs
dir = /var/data_backup

[block_backend]
name = fs
dir = /var/data_backup
```

--------------------------------

### SeaDrive Silent Installation Command

Source: https://manual.seafile.com/latest/config/auto_login_seadrive

Install SeaDrive silently using msiexec with quiet and no-restart options. Requires administrator privileges and generates an installation log.

```batch
msiexec /i seadrive.msi /quiet /qn /log install.log
```

--------------------------------

### Verify Frontend Node Logs

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_docker

Example output indicating a successful startup of the frontend node.

```text
*** Running /etc/my_init.d/01_create_data_links.sh...
*** Booting runit daemon...
*** Runit started as PID 20
*** Running /scripts/enterpoint.sh...
2024-11-21 03:02:35 Nginx ready 

2024-11-21 03:02:35 This is an idle script (infinite loop) to keep container running. 
---------------------------------

Seafile cluster frontend mode

---------------------------------


Starting seafile server, please wait ...
Seafile server started

Done.

Starting seahub at port 8000 ...

Seahub is started

Done.
```

--------------------------------

### Install Python Dependencies via Pip

Source: https://manual.seafile.com/latest/setup_binary/installation

Installs required Python packages into the active virtual environment. This command should be run after activating the venv to avoid system-wide installation.

```bash
pip3 install --timeout=3600 boto3 oss2 twilio configparser pytz \
    sqlalchemy==2.0.* pymysql==1.1.* jinja2 django-pylibmc pylibmc psd-tools lxml \
    django==5.2.* cffi==1.17.1 future==1.0.* mysqlclient==2.2.* captcha==0.7.* django_simple_captcha==0.6.* \
    pyjwt==2.10.* djangosaml2==1.11.* pysaml2==7.5.* pycryptodome==3.23.* python-ldap==3.4.* pillow==11.3.* pillow-heif==1.0.* cairosvg==2.8.* scikit-learn==1.7.*
```

--------------------------------

### Install frontend dependencies

Source: https://manual.seafile.com/latest/develop/server?q=

Installs required JavaScript modules for the frontend.

```bash
cd /root/dev/source-code/seahub/frontend

npm install
```

--------------------------------

### Upgrade Script List Output

Source: https://manual.seafile.com/latest/upgrade/upgrade?q=

Example output showing available upgrade script files.

```text
...
upgrade_5.0_5.1.sh
upgrade_5.1_6.0.sh
upgrade_6.0_6.1.sh
```

```text
...
upgrade/upgrade_5.1_6.0.sh
upgrade/upgrade_6.0_6.1.sh
upgrade/upgrade_6.1_6.2.sh
```

--------------------------------

### Start Seafile Server (Frontend Node)

Source: https://manual.seafile.com/latest/upgrade/upgrade_a_cluster_binary?q=

Start the Seafile and Seahub services on the frontend node after the upgrade. Ensure the Python virtual environment is activated if applicable.

```bash
cd /opt/seafile/seafile-server-latest
su seafile
./seafile.sh start
./seahub.sh start
```

--------------------------------

### Start ClamAV daemon

Source: https://manual.seafile.com/latest/extension/virus_scan_with_clamav?q=

Start the ClamAV service using systemctl.

```bash
systemctl start clamav-daemon
```

--------------------------------

### Package Sync Client

Source: https://manual.seafile.com/latest/develop/windows?q=

Commands to build the release version and generate the MSI installer.

```shell
$ cd seafile-workspace/seafile-client/third_party/quazip
$ devenv quazip.sln /build Release|x64
$ cd seafile-workspace/seafile/scripts/build
$ python build-msi-vs.py 1.0.0
```

--------------------------------

### Start seahub

Source: https://manual.seafile.com/latest/develop/server?q=

Starts the seahub development server on port 8000.

```bash
python3 manage.py runserver 0.0.0.0:8000
```

--------------------------------

### Start Seafile Server Components

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x

Execute the startup scripts for the Seafile server and Seahub web interface.

```bash
./seafile.sh start # starts seaf-server
./seahub.sh start  # starts seahub
```

--------------------------------

### Install Seafile Python Libraries

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_11.0.x

Install or upgrade required Python libraries for Seafile 11.0 using pip3. Ensure you are using root or sudo mode for system-wide installation.

```bash
sudo pip3 install future==0.18.*
mysqlclient==2.1.*
pillow==10.2.*
s sqlalchemy==2.0.18
captcha==0.5.*
django_simple_captcha==0.6.*
djangosaml2==1.5.*
pysaml2==7.2.*
pycryptodome==3.16.*
cffi==1.15.1
python-ldap==3.4.3

```

--------------------------------

### Install Nginx for Load Balancing

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_docker

Install Nginx on the host machine to set up a load balancing service for the Seafile cluster. This command updates package lists and installs Nginx.

```bash
sudo apt update
sudo apt install nginx
```

--------------------------------

### Prepare index-server directories

Source: https://manual.seafile.com/latest/extension/distributed_indexing

Create the necessary directory structure for index-server nodes.

```bash
mkdir -p /opt/seafile-data/seafile/conf
mkdir -p /opt/seafile
```

--------------------------------

### Install and configure Memcached

Source: https://manual.seafile.com/latest/setup_binary/installation

Commands to install Memcached and configure the environment for Seafile.

```bash
# on Debian/Ubuntu 18.04+
apt-get install memcached libmemcached-dev -y

# activate the venv
source python-venv/bin/activate
pip3 install --timeout=3600 pylibmc django-pylibmc

systemctl enable --now memcached
```

```text
## Cache
CACHE_PROVIDER=memcached

### Memcached
MEMCACHED_HOST='<your memcached host>'
MEMCACHED_PORT=11211
```

--------------------------------

### Start Seafile Server (Binary Package)

Source: https://manual.seafile.com/latest/upgrade/upgrade

After the upgrade scripts have been executed, start the Seafile server using these commands. Choose the appropriate command based on your Seahub deployment method (direct or fastcgi).

```bash
cd seafile/seafile-server-latest/
./seafile.sh start
./seahub.sh start # or "./seahub.sh start-fastcgi" if you're using fastcgi
# or via service
/etc/init.d/seafile-server start
```

--------------------------------

### Test ClamAV installation

Source: https://manual.seafile.com/latest/extension/virus_scan_with_clamav?q=

Verify the installation by scanning the EICAR test file.

```bash
$ curl https://secure.eicar.org/eicar.com.txt | clamdscan -
```

--------------------------------

### Enable Services at Boot

Source: https://manual.seafile.com/latest/setup_binary/start_seafile_at_system_bootup

Commands to enable the configured services to start automatically at system boot.

```bash
sudo systemctl enable seafile.service
sudo systemctl enable seahub.service
sudo systemctl enable seafile-client.service   # optional
```

--------------------------------

### Start seaf-server

Source: https://manual.seafile.com/latest/develop/server?q=

Launches the seaf-server process with specified configuration, data, and log directories.

```bash
seaf-server -F /root/dev/conf -d /root/dev/seafile-data -l /root/dev/logs/seafile.log >> /root/dev/logs/seafile.log 2>&1 &
```

--------------------------------

### Install ClamAV on Linux

Source: https://manual.seafile.com/latest/extension/virus_scan_with_clamav?q=

Install the necessary ClamAV packages using apt-get.

```bash
apt-get install clamav-daemon clamav-freshclam
```

--------------------------------

### Run frontend development server

Source: https://manual.seafile.com/latest/develop/server?q=

Starts the frontend development build process.

```bash
cd /root/dev/source-code/seahub/frontend

npm run dev
```

--------------------------------

### Install Python dependencies

Source: https://manual.seafile.com/latest/develop/server

Install required Python packages and upgrade pip.

```bash
apt-get install -y python3 python3-dev python3-pip python3-setuptools python3-ldap

python3 -m pip install --upgrade pip

pip3 install pytz jinja2 Django==5.2.* django-statici18n==2.3.* django_webpack_loader==1.7.* django_picklefield==3.1 django_formtools==2.4 django_simple_captcha==0.6.* djangosaml2==1.11.* djangorestframework==3.14.* python-dateutil==2.8.* pyjwt==2.10.* pycryptodome==3.23.* python-cas==1.6.* pysaml2==7.5.* requests==2.28.* requests_oauthlib==1.3.* future==1.0.* gunicorn==20.1.* mysqlclient==2.2.* qrcode==7.3.* pillow==11.3.* pillow-heif==1.0.* chardet==5.1.* cffi==1.17.1 captcha==0.7.* openpyxl==3.0.* Markdown==3.4.* bleach==5.0.* python-ldap==3.4.* sqlalchemy==2.0.* redis mock pytest pymysql==1.1.* configparser pylibmc django-pylibmc nose exam splinter pytest-django psd-tools lxml cairosvg==2.8.*
```

--------------------------------

### Check Initialization Logs

Source: https://manual.seafile.com/latest/setup/helm_chart_cluster

View the startup logs to verify the cluster initialization process.

```bash
Defaulted container "seafile-backend" out of: seafile-backend, set-ownership (init)
*** Running /etc/my_init.d/01_create_data_links.sh...
*** Booting runit daemon...
*** Runit started as PID 15
*** Running /scripts/enterpoint.sh...
2025-02-13 08:58:35 Nginx ready 
2025-02-13 08:58:35 This is an idle script (infinite loop) to keep container running. 

---------------------------------

Seafile cluster backend mode

---------------------------------

[2025-02-13 08:58:35] Now running setup-seafile-mysql.py in auto mode.
Checking python on this machine ...


verifying password of user root ...  done

---------------------------------
This is your configuration
---------------------------------

    server name:            seafile
    server ip/domain:       10.0.0.138

    seafile data dir:       /opt/seafile/seafile-data
    fileserver port:        8082

    database:               create new
    ccnet database:         ccnet_db
    seafile database:       seafile_db
    seahub database:        seahub_db
    database user:          seafile


Generating seafile configuration ...

done
Generating seahub configuration ...

----------------------------------------
Now creating seafevents database tables ...

----------------------------------------
----------------------------------------
Now creating ccnet database tables ...

----------------------------------------
----------------------------------------
Now creating seafile database tables ...

----------------------------------------
----------------------------------------
Now creating seahub database tables ...

----------------------------------------


-----------------------------------------------------------------
Your seafile server configuration has been finished successfully.
-----------------------------------------------------------------


[2025-02-13 08:58:36] Updating version stamp
Start init

Init success
```

--------------------------------

### Start seaf-fuse in Docker

Source: https://manual.seafile.com/latest/extension/fuse

Commands to initialize the container and start the FUSE service.

```bash
docker compose up -d

docker exec -it seafile bash
```

```bash
cd /opt/seafile/seafile-server-latest/

./seaf-fuse.sh start /seafile-fuse
```

--------------------------------

### Verify Seafile backend logs

Source: https://manual.seafile.com/latest/setup/cluster_deploy_with_docker?q=

Example output indicating a successful startup of the Seafile backend node.

```text
*** Running /etc/my_init.d/01_create_data_links.sh...
*** Booting runit daemon...
*** Runit started as PID 21
*** Running /scripts/enterpoint.sh...
2024-11-21 03:11:59 Nginx ready 
2024-11-21 03:11:59 This is an idle script (infinite loop) to keep container running. 

---------------------------------

Seafile cluster backend mode

---------------------------------


Starting seafile server, please wait ...
Seafile server started

Done.

Starting seafile background tasks ...
Done.
```

--------------------------------

### FileNotFoundError Example

Source: https://manual.seafile.com/latest/develop/translation

Example of the error message encountered during static file collection.

```text
FileNotFoundError: [Errno 2] No such file or directory: '/opt/seafile/seafile-server-latest/seahub/frontend/build'
```

--------------------------------

### Install Python Libraries for Ubuntu 22.04 / Debian 11

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x?q=

Installs required Python libraries for Seafile on Ubuntu 22.04 or Debian 11. Use root or sudo mode for system-wide installation.

```bash
sudo pip3 install future==1.0.* mysqlclient==2.1.* pillow==10.4.* sqlalchemy==2.0.* pillow_heif==0.18.0 \
gevent==24.2.* captcha==0.6.* django_simple_captcha==0.6.* djangosaml2==1.9.* \
pysaml2==7.2.* pycryptodome==3.16.* cffi==1.15.1 python-ldap==3.2.0

```

--------------------------------

### Install Python Libraries for Ubuntu 24.04 / Debian 12

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x?q=

Installs required Python libraries for Seafile on Ubuntu 24.04 or Debian 12. Use root or sudo mode for system-wide installation.

```bash
sudo pip3 install future==1.0.* mysqlclient==2.2.* pillow==10.4.* sqlalchemy==2.0.* pillow_heif==0.18.0 \
gevent==24.2.* captcha==0.6.* django_simple_captcha==0.6.* djangosaml2==1.9.* \
pysaml2==7.3.* pycryptodome==3.20.* cffi==1.17.0 python-ldap==3.4.*

```

--------------------------------

### Start Seafile Server on Kubernetes

Source: https://manual.seafile.com/latest/setup/k8s_single_node

Apply the Seafile Kubernetes YAML configurations to deploy the server. Ensure the namespace 'seafile' is used for management.

```bash
kubectl apply -f /opt/seafile-k8s-yaml/ -n seafile

```

--------------------------------

### Install Python libraries

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_13.0.x?q=

Install required Python packages system-wide using pip3.

```bash
pip3 install --timeout=3600 boto3 oss2 twilio configparser pytz \
sqlalchemy==2.0.* pymysql==1.1.* jinja2 django-pylibmc pylibmc redis django-redis psd-tools lxml \
django==5.2.* cffi==1.17.1 future==1.0.* mysqlclient==2.2.* captcha==0.7.* django_simple_captcha==0.6.* \
pyjwt==2.10.* djangosaml2==1.11.* pysaml2==7.5.* pycryptodome==3.23.* python-ldap==3.4.* pillow==11.3.* pillow-heif==1.0.* cairosvg==2.8.* scikit-learn==1.7.*
```

--------------------------------

### Download Seafile Pro configuration files

Source: https://manual.seafile.com/latest/setup/migrate_ce_to_pro_with_docker

Use wget to fetch the required environment and configuration files for the Pro edition.

```bash
wget -O .env https://manual.seafile.com/13.0/repo/docker/pro/env
wget https://manual.seafile.com/13.0/repo/docker/pro/seafile-server.yml
wget https://manual.seafile.com/13.0/repo/docker/pro/elasticsearch.yml
```

--------------------------------

### Start Seafile Server (Backend Node)

Source: https://manual.seafile.com/latest/upgrade/upgrade_a_cluster_binary?q=

Start the Seafile and Seafile background tasks services on the backend node after the upgrade. Ensure the Python virtual environment is activated if applicable.

```bash
cd /opt/seafile/seafile-server-latest
su seafile
./seafile.sh start
./seafile-background-tasks.sh start
```

--------------------------------

### Start seafevents

Source: https://manual.seafile.com/latest/develop/server?q=

Initializes the seafevents service using the main.py script.

```bash
cd /root/dev/source-code/seafevents/
python3 main.py --loglevel=debug --logfile=/root/dev/logs/seafevents.log --config-file /root/dev/conf/seafevents.conf >> /root/dev/logs/seafevents.log 2>&1 &
```

--------------------------------

### Install Python Libraries (Ubuntu 22.04 / Debian 11)

Source: https://manual.seafile.com/latest/upgrade/upgrade_notes_for_12.0.x

Installs required Python libraries for Seafile 12.0 on Ubuntu 22.04 or Debian 11. Use root or sudo mode for system-wide installation.

```bash
sudo pip3 install future==1.0.* mysqlclient==2.1.* pillow==10.4.* sqlalchemy==2.0.* pillow_heif==0.18.0 \
gevent==24.2.* captcha==0.6.* django_simple_captcha==0.6.* djangosaml2==1.9.* \
pysaml2==7.2.* pycryptodome==3.16.* cffi==1.15.1 python-ldap==3.2.0
```

--------------------------------

### Install Seafile Helm Chart

Source: https://manual.seafile.com/latest/setup/helm_chart_cluster

Add the repository and deploy the Seafile cluster.

```bash
helm repo add seafile https://haiwen.github.io/seafile-helm-chart/repo
helm upgrade --install seafile seafile/cluster --version 13.0 --namespace seafile --create-namespace --values my-values.yaml
```
Tokens:
Raw