https://github.com/moritzfl/docker-fiduswriter
Docker image for fiduswriter collaborative writing tool
https://github.com/moritzfl/docker-fiduswriter
Last synced: about 1 year ago
JSON representation
Docker image for fiduswriter collaborative writing tool
- Host: GitHub
- URL: https://github.com/moritzfl/docker-fiduswriter
- Owner: moritzfl
- License: agpl-3.0
- Archived: true
- Created: 2017-04-12T14:57:16.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-01-20T17:32:18.000Z (over 2 years ago)
- Last Synced: 2024-11-04T09:37:26.315Z (over 1 year ago)
- Language: Shell
- Homepage: https://hub.docker.com/r/moritzf/fiduswriter/
- Size: 91.8 KB
- Stars: 6
- Watchers: 1
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starred - moritzfl/docker-fiduswriter - Docker image for fiduswriter collaborative writing tool (others)
README
# Discontinued
This project is discontinued. Development does continue based on this project at the official [fiduswriter-docker project](https://github.com/fiduswriter/fiduswriter-docker)
# docker-fiduswriter
[](https://hub.docker.com/r/moritzf/fiduswriter/)
[](https://hub.docker.com/r/moritzf/fiduswriter/)
[](https://hub.docker.com/r/moritzf/fiduswriter/)
[FidusWriter](https://github.com/fiduswriter/fiduswriter) is a collaborative online writing tool. This is a docker image that was built following the official installation manual for Ubuntu as closely as possible.
## Builds and Tags on DockerHub
Builds on Docker are tagged following this pattern and are triggered automatically through changes in [this project (moritzfl/docker-fiduswriter)](https://github.com/moritzfl/docker-fiduswriter) ("develop" ist triggered by commits, the others through releases):
- __latest__: latest release or prerelease of fiduswriter (most current "release-\[VERSION\]" or "prerelease-\[VERSION\]")
- __latest-stable__: version representing the latest stable release of fiduswriter (most current "release-\[VERSION\]")
- __release-\[VERSION\]__: a stable release of fiduswriter (equivalent to "release" on fiduswriter-repo)
- __prerelease-\[VERSION\]__: a potentially unstable version of fiduswriter (equivalent to "prerelease" on fiduswriter-repo)
- __develop__: a development build is done after each commit
## How to use this image
You will need to modify the entries for ALLOWED_HOSTS in the file /data/configuration.py in order to allow __access__ from any __URL other than localhost__. I would recommend mapping the data directory to a directory on your host machine for data persistence and easy configuration (follow the instrucions below).
Until you define a mail-server (also through /data/configuration.py), the mails and contained __links required for user registration__ get printed to the __outputstream of the container__.
In order to persist data, you __must grant write access for the executing user (fiduswriter)__ to the data directory that you want to map to on the host. This can be achieved by issuing the command below. If you do not ensure access to the desired directory on the host, fiduswriter will not run correctly.
~~~~
$ sudo chown -R 999:999 /host/directory
~~~~
(Replace "/host/directory" with a valid directory on your host machine)
To get fiduswriter running use (you can do without -v /host/directory:/data but that means no persistent data):
~~~~
$ docker run -d -v /host/directory:/data -p 8000:8000 --name moritzf-fiduswriter moritzf/fiduswriter:latest
~~~~
(Replace "/host/directory" with a valid directory on your host machine)
If needed, you can create an administrative account for fiduswriter by attaching the container to your terminal and issuing the following command:
~~~~
$ python3 manage.py createsuperuser
~~~~