9c3fdcae32
* didn't use launcher * travis * link error & update readme * del launcher.ps1, del bootstrap func under launcher file * [readme] password/plan b, add a new admin * review
4.9 KiB
About
-
Docker is an open source project to pack, ship and run any Linux application in a lighter weight, faster container than a traditional virtual machine.
-
Docker makes it much easier to deploy a Seafile server on your servers and keep it updated.
-
The base image configures Seafile with the Seafile team's recommended optimal defaults.
Getting Started
Download seafile image, and run the image.
docker run -d --name seafile-server -v /opt/seafile-data:/shared -p 80:80 seafileltd/seafile:6.2.1
Now visit http://hostname or https://hostname to open Seafile Web UI.
If you are not familiar with docker commands, refer to docker documentation.
More configuration option
Custom admin username and password
The default account is me@example.com and the password is asecret. It will be created when the container is first run.
The default values can also be changed by setting the container's environment variables
e.g.
docker run -d --name seafile-server -e "SEAFILE_ADMIN_EMAIL=me@example.com" -e "SEAFILE_ADMIN_PASSWORD=asecret" -v /opt/seafile-data:/shared -p 80:80 seafileltd/seafile:6.2.1
If you forget the admin password, you can add a new admin account and then go to the sysadmin panel to reset user password.
Domain
The default value is seafile.example.com, you can set environ to docker container.
e.g.
docker run -d --name seafile-server -e "SEAFILE_SERVER_HOSTNAME=seafile.example.com" -v /opt/seafile-data:/shared -p 80:80 seafileltd/seafile:6.2.1
And then nginx will update up config.
Let's encrypt SSL certificate
If you set SEAFILE_SERVER_LETSENCRYPT to true, the bootstrap script would request a letsencrypt-signed SSL certificate for you.
e.g.
docker run -d --name seafile-server -e "SEAFILE_SERVER_LETSENCRYPT=true" -v /opt/seafile-data:/shared -p 80:80 -p 443:443 seafileltd/seafile:6.2.1
If you want to use your own SSL certificate:
- create a folder 'shared/ssl', and put your certificate and private key under the ssl directory.
- Assume your site name is "seafile.example.com", then your certificate must have the name "seafile.example.com.crt", and the private key must have the name "seafile.example.com.key".
Modify configurations
The config files are under shared/seafile/conf. You can modify the configurations according to Seafile manual
After modification, run the new docker container:
docker rm -fseafile-server
docker run -d --name seafile-server -v /root/seafile:/shared -p 80:80 seafileltd/seafile:6.2.1
Find logs
The seafile logs are under shared/logs/seafile.
The system logs are under shared/logs/var-log.
Add a new Admin
Enter the command below.
docker exec -it seafile-server /opt/seafile/seafile-server-latest/reset-admin.sh
Enter the username and password according to the prompts.You now have a new admin account.
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.
- /shared/db: This is the data directory for mysql server
- /shared/seafile: This is the directory for seafile server configuration and data.
- /shared/logs: This is the directory for logs.
- /shared/logs/var-log: This is the directory that would be mounted as
/var/loginside the container. For example, you can find the nginx logs inshared/logs/var-log/nginx/. - /shared/logs/seafile: This is the directory that would contain the log files of seafile server processes. For example, you can find seaf-server logs in
shared/logs/seafile/seafile.log.
- /shared/logs/var-log: This is the directory that would be mounted as
- /shared/ssl: This is directory for certificate, which does not exist by default.
- /shared/bootstrap.conf: This file does not exist by default. You can create it by your self, and write the configuration of files similar to the
samplesfolder.
Upgrading Seafile Server
If you are one of the users who use the launcher update. You can refer to upgrade from old format
ensure same version of the repo, and run start command
docker run -d --name seafile-server -v ${data_path}:/shared -p 80:80 seafileltd/seafile:6.2.1
which would keep your seafile server up to date.
Troubleshooting
You can run the command as "docker logs" or "docker exec" to find errors.
Special Thanks
Lots of the design of this repo is borrowed from the excellent discourse-docker project. Thanks for their insipiration!
License
Apache