Difference between revisions of "Seafile"

From ArchWiki
Jump to navigation Jump to search
m (Installation)
Line 16: Line 16:
 
As root, add a new user to run seafile server instances under:
 
As root, add a new user to run seafile server instances under:
  
  # useradd -m -r -d /srv/seafile -s /bin/false seafile
+
  # useradd -m -r -d /srv/seafile -s /bin/nologin seafile
  
 
=== Setup a server instance ===
 
=== Setup a server instance ===

Revision as of 04:52, 25 June 2014


Seafile is an open source cloud storage system, with advanced support for file syncing, privacy protection and teamwork.

Collections of files are called libraries, and each library can be synced separately. A library can be encrypted with a user chosen password. This password is not stored on the server, so even the server admin can't view your file contents.

Seafile lets you create groups with file syncing, wiki, and discussion -- enabling easy collaboration around documents within a team.

Server

Installation

Install seafile-serverAUR from the Arch User Repository

As root, add a new user to run seafile server instances under:

# useradd -m -r -d /srv/seafile -s /bin/nologin seafile

Setup a server instance

Change to the user previously setup in #Installation (following commands are to be executed as that user unless otherwise stated):

$ sudo -u seafile -s /bin/sh

As that user, create the directory layout for the new seafile server instance and change directory to it:

$ mkdir -p $HOME/example.org/seafile-server
$ cd $HOME/example.org

Note: Replace every occurence of 'example.org' on this page with the actual domain of your new server instance

Determine the appropriate seahub version (it will be shown in the format 'x.y.z-r', e.g. 3.0.2):

$ pacman -Qi seafile-server | grep Version

Set the SEAFILE_SERVER_VERSION variable to the 'x.y.z' retrieved in the previous step:

$ SEAFILE_SERVER_VERSION=3.0.3

Download seahub and extract it:

$ wget -P seafile-server https://github.com/haiwen/seahub/archive/v$SEAFILE_SERVER_VERSION-server.tar.gz
$ tar -xz -C seafile-server -f seafile-server/v$SEAFILE_SERVER_VERSION-server.tar.gz

Rename the extracted directory:

$ mv seafile-server/seahub-$SEAFILE_SERVER_VERSION-server seafile-server/seahub

To create the configuration for the seafile server instance, run

$ seafile-admin setup

and follow the instructions now showing on your screen. See the seafile wiki for a detailed explanation of the seafile-admin script.

Now, copy the systemd service for seafile 'seafile-server@.service' from /usr/lib/systemd/system/ to /etc/systemd/system and replace the two occurences of '%h' in it with the actual $HOME for the user setup in #Installation.

To manually start your new seafile server, run as root:

# systemctl start seafile-server@example.org

To automatically start your new seafile server at system startup, run as root:

# systemctl enable seafile-server@example.org

Deploy an instance with Nginx

In order to deploy Seafile's webinterface "seahub" with Nginx, you can use an Nginx configuration similar to this:

server {
    listen 80;
    server_name www.example.org example.org;
    rewrite ^/(.*) https://$server_name/$1 permanent;   # force redirect http to https
}

server {
    listen 443;
    ssl on;
    ssl_certificate /etc/ssl/certs/example.org.crt;
    ssl_certificate_key /etc/ssl/private/server.key;
    server_name www.example.org example.org;

    location / {
        fastcgi_pass    127.0.0.1:8000;
        fastcgi_param   SCRIPT_FILENAME     $document_root$fastcgi_script_name;
        fastcgi_param   PATH_INFO           $fastcgi_script_name;

        fastcgi_param   SERVER_PROTOCOL     $server_protocol;
        fastcgi_param   QUERY_STRING        $query_string;
        fastcgi_param   REQUEST_METHOD      $request_method;
        fastcgi_param   CONTENT_TYPE        $content_type;
        fastcgi_param   CONTENT_LENGTH      $content_length;
        fastcgi_param   SERVER_ADDR         $server_addr;
        fastcgi_param   SERVER_PORT         $server_port;
        fastcgi_param   SERVER_NAME         $server_name;

        fastcgi_param   HTTPS on;
        fastcgi_param   HTTP_SCHEME https;
    }

    location /seafhttp {
        rewrite ^/seafhttp(.*)$ $1 break;
        proxy_pass http://127.0.0.1:8082;
        client_max_body_size 0;
    }

    location /media {
        root {ABSOLUTE_PATH_TO_SEAFILE_USER'S_HOME}/example.org/seafile-server/seahub;
    }
}

Upgrading

First, stop each of your seafile server instances (repeat for example.org, foo.bar, etc.) as root:

# systemctl stop seafile-server@example.org

Upgrade seafile-serverAUR from the Arch User Repository.

Become the user the seafile server instances run as (following commands are to be executed as that user unless otherwise stated):

$ sudo -u seafile -s

Repeat the following for each seafile server instance:

Change directory to the server instance's 'seafile-server' subdirectory:
$ cd /srv/seafile/example.org/seafile-server
Run the preupgrade script (Or do the steps by hand, see the Seafile wiki):
$ seahub-preupgrade
Run the appropriate seafile/seahub upgrade script from the upgrade subdirectory:
For a minor upgrade (x.y.a to x.y.b with a < b):
$ ./upgrade/minor-upgrade.sh
For a major upgrade (x.y.a to z.w.b with x < z || y < w):
$ ./upgrade/upgrade_x.y_z.w.sh

Lastly, start each of your seafile server instances again (repeat for example.org, foo.bar, etc.) as root:

# systemctl start seafile-server@example.org

Sources