Deploy Seafile with Docker

The official Docker image uses multiple containers. If you need to run Seafile and related database in a single container for Synology platform, you can try the docker image provided by community: https://github.com/codeoutin/seafile7/

Getting started

Install docker-compose

Seafile v7.x.x image uses docker-compose. You should first install the docker-compose command.

# for CentOS
yum install docker-compose -y
# for Ubuntu
apt-get install docker-compose -y

Download and modify docker-compose.yml

Download docker-compose.yml sample file to your host. Then modify the file according to your environtment. The following fields are needed to be modified:

Start Seafile server

Start Seafile server with the following command

docker-compose up -d

Wait for a few minutes for the first time initialization, then visit http://seafile.example.com to open Seafile Web UI.

...

More configuration options

Custom admin username and password

The default admin account is me@example.com and the password is asecret. You can use a different password by setting the container's environment variables in the docker-compose.yml: e.g.

seafile:
    ...
    environment:
        ...
        - SEAFILE_ADMIN_EMAIL=me@example.com
        - SEAFILE_ADMIN_PASSWORD=a_very_secret_password
        ...

Let's encrypt SSL certificate

If you set SEAFILE_SERVER_LETSENCRYPT to true, the container would request a letsencrypt-signed SSL certificate for you automatically.

e.g.

seafile:
    ...
    ports:
        - "80:80"
        - "443:443"
    ...
    environment:
        ...
        - SEAFILE_SERVER_LETSENCRYPT=true
        - SEAFILE_SERVER_HOSTNAME=docs.seafile.com
        ...

If you want to use your own SSL certificate and the volume directory of Seafile data is /opt/seafile-data:

Modify Seafile server configurations

The config files are under shared/seafile/conf. You can modify the configurations according to Seafile manual

After modification, you need to restart the container:

docker-compose restart

Find logs

The Seafile logs are under shared/logs/seafile in the docker, or /opt/seafile-data/logs/seafile in the server that run the docker.

The system logs are under shared/logs/var-log, or /opt/seafile-data/logs/var-log in the server that run the docker.

Add a new admin

Ensure the container is running, then enter this command:

docker exec -it seafile /opt/seafile/seafile-server-latest/reset-admin.sh

Enter the username and password according to the prompts. You now have a new admin account.

Seafile directory structure

/shared

Placeholder spot for shared volumes. You may elect to store certain persistent information outside of a container, in our case we keep various logfiles and upload directory outside. This allows you to rebuild containers easily without losing important information.

Upgrading Seafile server

To upgrade to latest version of seafile server:

docker pull seafileltd/seafile-mc:latest
docker-compose down
docker-compose up -d

Backup and recovery

Struct

We assume your seafile volumns path is in /opt/seafile-data. And you want to backup to /opt/seafile-backup directory. You can create a layout similar to the following in /opt/seafile-backup directory:

/opt/seafile-backup
---- databases/  MySQL contains database backup files
---- data/  Seafile contains backups of the data directory

The data files to be backed up:

/opt/seafile-data/seafile/conf  # configuration files
/opt/seafile-data/seafile/seafile-data # data of seafile
/opt/seafile-data/seafile/seahub-data # data of seahub

Backup

Steps:

  1. Backup the databases;

  2. Backup the seafile data directory;

Backup Order: Database First or Data Directory First

Recovery

Garbage collection

When files are deleted, the blocks comprising those files are not immediately removed as there may be other files that reference those blocks (due to the magic of deduplication). To remove them, Seafile requires a 'garbage collection' process to be run, which detects which blocks no longer used and purges them. (NOTE: for technical reasons, the GC process does not guarantee that every single orphan block will be deleted.)

The required scripts can be found in the /scripts folder of the docker container. To perform garbage collection, simply run docker exec seafile /scripts/gc.sh. For the community edition, this process will stop the seafile server, but it is a relatively quick process and the seafile server will start automatically once the process has finished. The Professional supports an online garbage collection.

Troubleshooting

You can run docker commands like "docker exec" to find errors.

docker exec -it seafile /bin/bash

Last modified by seafile, 2024-01-30

Getting started
Install docker-compose
Download and modify docker-compose.yml
Start Seafile server
More configuration options
Custom admin username and password
Let's encrypt SSL certificate
Modify Seafile server configurations
Find logs
Add a new admin
Seafile directory structure
/shared
Upgrading Seafile server
Backup and recovery
Struct
Backup
Recovery
Garbage collection
Troubleshooting