summaryrefslogtreecommitdiffstats
path: root/net/seafile-server/README.md
blob: e4bd47a942582640ffc0ce2b5a3864d9b3aee763 (plain)
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
# Seafile Server on OpenWrt

## Installation Notes

### First-time Installation

1.  Consider where you would like the Seafile data directory
    (`seafile-data`), Seahub data directory (`seahub-data`), and the
    Seahub database (`seahub.db`, if you will be using SQLite) to be
    stored.

    This location can be configured in `/etc/config/seafile-server`
    (using the _data_dir_ option); the default is `/usr/share/seafile`.

    If you are certain you will use a custom location, set this location
    in `/etc/config/seafile-server` before continuing with the other
    installation steps.

2.  Run one of the two setup scripts:

    *   To use SQLite:

            # setup-seafile

    *   To use MySQL:

            # setup-seafile-mysql

3.  Create a Seafile admin account:

        # create-seafile-admin

4.  Start Seafile server:

        # service seafile-server start


### Upgrading

Please run the appropriate upgrade scripts in
`/usr/share/seafile/seafile-server/upgrade` before using the new
version.

For more information, see
https://download.seafile.com/published/seafile-manual/upgrade/upgrade.md.

Note that since version 7.1, configuration files are stored in
`/etc/seafile` instead of `/usr/share/seafile`.

If you are upgrading from a version before 7.1:

1.  Run the upgrade scripts in
    `/usr/share/seafile/seafile-server/upgrade` up to 7.1.

2.  Move the `conf` and `ccnet` directories from `/usr/share/seafile` to
    `/etc/seafile`.

3.  If you are using a custom Seafile data directory location and have
    set this in `ccnet/seafile.ini`:

    Starting with 7.1, the Seafile data directory location will be taken
    from `/etc/config/seafile-server`, and any setting in
    `ccnet/seafile.ini` will be ignored.

    It is strongly recommended to migrate the custom location setting to
    `/etc/config/seafile-server` and rename/remove the `seafile.ini`
    file.

    Note that the _data_dir_ option in /etc/config/seafile-server
    determines the *parent* path to the Seafile data directory (along
    with the Seahub data directory and the Seahub database, if you are
    using SQLite). The actual Seafile data directory must be named
    `seafile-data`.

    For example, if your Seafile data directory is
    `/srv/seafile/my-seafile-data`:

    1.  Rename the directory to `seafile-data`, so now the Seafile data
        directory is `/srv/seafile/seafile-data`.

    2.  Move the Seahub data directory (`seahub-data`) from
        `/usr/share/seafile` into `/srv/seafile`.

    3.  If you are using SQLite, move the Seahub database (`seahub.db`)
        from `/usr/share/seafile` into `/srv/seafile`.

    4.  Set the _data_dir_ option in `/etc/config/seafile-server` to the
        parent path, `/srv/seafile`.

    5.  Rename or delete `ccnet/seafile.ini`.

4.  Review/update your Seahub settings. In previous versions of the
    Seahub OpenWrt package, some of Seahub's default settings (in
    `/usr/share/seafile/seafile-server/seahub/seahub/settings.py`) were
    modified from the defaults shipped by upstream.

    Starting with 7.1, Seahub's default settings are the same as
    [upstream][seahub_settings], with custom settings added to
    `/etc/seafile/conf/seahub_settings.py` during setup for new
    installations.

    To use the same custom settings in your upgraded installation, add
    these lines to `/etc/seafile/conf/seahub_settings.py`:

        # Custom settings for OpenWrt
        USE_I18N = False
        USER_PASSWORD_MIN_LENGTH = 8
        USER_STRONG_PASSWORD_REQUIRED = True

    [seahub_settings]: https://github.com/haiwen/seahub/blob/v7.1.2-server/seahub/settings.py

5.  Continue running the upgrade scripts up to the new version.