mirror of https://github.com/YunoHost-Apps/outline_ynh.git synced 2024-09-03 19:56:12 +02:00

An open, extensible, wiki for your team built using React and Node.js

closember

Find a file

yunohost-bot c9b27df250 Auto-update README		2022-07-22 06:35:17 +00:00
.github	Initial commit	2021-09-21 04:55:53 +06:30
conf	Update to v0.65.2	2022-07-21 16:34:47 +02:00
doc	Update to v0.65.2	2022-07-21 16:34:47 +02:00
scripts	Stupid mistake...	2022-05-10 16:45:43 +07:00
sources	Update to v0.65.2	2022-07-21 16:34:47 +02:00
.gitignore	Remove .DS_Store	2021-11-09 14:42:41 +07:00
check_process	Update check_process	2022-04-18 16:18:08 +07:00
LICENSE	Create LICENSE	2021-09-21 06:35:08 +08:00
manifest.json	Update to v0.65.2	2022-07-21 16:34:47 +02:00
README.md	Auto-update README	2022-07-22 06:35:17 +00:00
README_fr.md	Auto-update README	2022-07-22 06:35:17 +00:00

README.md

Outline for YunoHost

Lire ce readme en français.

This package allows you to install Outline quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

The fastest wiki and knowledge base for growing teams. Beautiful, feature rich, and markdown compatible.

Features

Fully working installation of Outline wiki
Including a MinIO server for avatars and picture object storage
Including a Dex server to connect to Yunohost's LDAP userbase using an OIDC auth flow
Using Yunohost's built-in SMTP server for notifications

Shipped version: 0.65.2~ynh1

Demo: https://app.getoutline.com/create

Screenshots

Disclaimers / important information

Not totally free licence

Outline is a softwared licenced under BUSL 1.1 licence. ⚠️ That licence is not totally free. Please read it very carefully if you have any commercial use in mind. The Outline version shipped with this package (v0.65.2) will be released under Apache-2.0 licence after May 23rd 2026.

Known limitations

The app can now run in the CI server and reach level 7. However, it is still very young and not broadly tested. Please use it with extreme care if it's on a prod server
The app requires MinIO app to be installed (MinIO installation and setup is automatic, though)
The app requires Dex app to be installed (Dex installation and setup is automatic, though)
The app is requiring three domains including two fully dedicated (one for MinIO server, one for Dex, one for Outline)
ARM architectures are not yet supported (But it should be achievable soon)
Because it's built from sources, the app requires an important amount of RAM, disk and time to install properly

How to create an admin user

The first user to login will automatically be granted admin rights You can then change the user rights by default and/or change the admin user afterwards from the Outline settings page

Documentation and resources

Official app website: <www.getoutline.com>
Official user documentation: https://www.getoutline.com/about
Official admin documentation: https://www.getoutline.com/developers
Upstream app code repository: https://github.com/outline/outline
YunoHost documentation for this app: https://yunohost.org/app_outline
Report a bug: https://github.com/YunoHost-Apps/outline_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/outline_ynh/tree/testing --debug
or
sudo yunohost app upgrade outline -u https://github.com/YunoHost-Apps/outline_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps