An open, extensible, knowledge base for your team.
Try out Outline using our hosted version at www.getoutline.com.
Deploy Outline on-premises to manage all of your data within your own cloud environment. This repository contains all the necessary scripts to install and run the enterprise edition of Outline on-prem. Please refer to the On Premise Guide during installation.
In this guide, we will walk through a simple, straightforward, setup on AWS EC2. Outline comes with images for a Postgres DB instance, as well a Minio for file storage.
For production deployments, we highly recommend you use something like RDS and S3 for these purposes. This can be done during the initial install process or configured after setup is complete.
- Choose Launch Instance from the EC2 dashboard.
- Select Ubuntu. Outline should work on any modern version.
- Select an instance type of
t2.smallor higher. - Set the network security groups for ports
22,80,443, and3000. Set sources set to0.0.0.0/0and::/0, and click Review and Launch.
- On the next screen, click Launch to start your instance.
- Before proceeding, go to your DNS provider and provision a subdomain where you would like to locate your Outline instance. For example
wiki.mycompany.com. Point this subdomain at the public IPv4 address of your EC2 instance. - If you're planning on using a managed database and file storage (like RDS and S3), this would be a good time to provision those as well:
- From your command line tool, SSH into your EC2 instance. You will need to clone this repository into your instance, so we recommend you use SSH agent forwarding
- Clone this repo on your instance:
git clone git@github.com:outline/outline-onprem.git. - Go into the cloned repo directory:
cd outline-onprem. - Run
./install.sh. This will install Docker and Docker Compose, and initialize some configuration files to be edited later. - Follow the instruction prompts. You will be asked to provide your provisioned subdomain at the end of this process.
- Run
sudo docker-compose pullto download images. - Open the configuration file
docker.envand add your license key as the value for the variableLICENSE_KEY. If you don't yet have a key because you're setting up a proof-of-concept or a trial, set the value totrial. - If you are using your own database and/or file storage, open
docker.envand modify the Postgres and S3 related configuration values. - Run
./database-setup.shto initialize your database. - Now you're read to start your Outline server with:
sudo docker-compose up -d. - Navigate to your server's address in a web browser. You will see a login screen with a placeholder Slack authentication method.
- To configure authentication for your org, open
docker.envand add your keys there for the identity providers you will be using.
Configuration for your installation of Outline is located in docker.env. Here, you can set up authentication (SSO and SAML), database, and file storage.
If you are using your own database and file storage, you can optimize your install footprint by modifying docker-compose.yml and removing the dependencies on postgres and minio.
Adding SAML to your outline install is a simple configuration change. Open docker.env and modify SAML_SSO_ENDPOINT and SAML_CERT to values provided by your IdP.
For an example setup guide using One Login, see the article below:
When there is patch or an update available for Outline, you can apply the updates to your instance by stopping your server and running the included update script: ./update.sh. We recommend backing up your database before updating.
Below is a list of common Docker commands. Note that you may need to prefix with sudo, depending on your setup
| Command | Description |
|---|---|
docker-compose up -d |
Starts containers -d means "detached", so containers continue to run in the background. |
docker-compose down |
Stops containers |
docker-compose logs -f |
Stream all container logs to stdout |