mirror of
https://github.com/0rangebananaspy/authelia.git
synced 2024-09-14 22:47:21 +07:00
08e674b62f
Updated all links to use https://www.authelia.com/docs/. Removed all comment sections from documented configuration on the documentation site and replaced them with their own sections. Made all documentation inside config.template.yml double hashes, and made all commented configuration sections single quoted. Added .yamllint.yaml to express our desired YAML styles. Added a style guide. Refactored many documentation areas to be 120 char widths where possible. It's by no means exhaustive but is a large start. Added a statelessness guide for the pending Kubernetes chart introduction. Added labels to configuration documentation and made many areas uniform.
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
---
|
|
layout: default
|
|
title: Contributing
|
|
nav_order: 7
|
|
has_children: true
|
|
---
|
|
|
|
# Contributing
|
|
|
|
## Development workflow
|
|
|
|
**Authelia** and its development workflow can be tested with Docker and docker-compose on Linux.
|
|
|
|
In order to deploy the current version of Authelia locally, run the following command and follow the instructions of
|
|
bootstrap.sh:
|
|
|
|
```console
|
|
$ source bootstrap.sh
|
|
```
|
|
|
|
Then, start the *Standalone* [suite].
|
|
```console
|
|
$ authelia-scripts suites setup Standalone
|
|
```
|
|
|
|
A [suite] is kind of a virtual environment for running Authelia in a complete ecosystem. If you want more details please
|
|
read the related [documentation](./suites.md).
|
|
|
|
## FAQ
|
|
|
|
### What version of Docker and docker-compose should I use?
|
|
|
|
Here are the versions used for testing in Buildkite:
|
|
|
|
```console
|
|
$ docker --version
|
|
Docker version 19.03.5, build 633a0ea838
|
|
|
|
$ docker-compose --version
|
|
docker-compose version 1.24.1, build unknown
|
|
```
|
|
|
|
### How can I serve my application under example.com?
|
|
|
|
Don't worry, you don't need to own the domain *example.com* to test Authelia. Copy the following lines in
|
|
your `/etc/hosts`.
|
|
|
|
```
|
|
192.168.240.100 home.example.com
|
|
192.168.240.100 login.example.com
|
|
192.168.240.100 singlefactor.example.com
|
|
192.168.240.100 public.example.com
|
|
192.168.240.100 secure.example.com
|
|
192.168.240.100 mail.example.com
|
|
192.168.240.100 mx1.mail.example.com
|
|
```
|
|
|
|
`192.168.240.100` is the IP attributed by Docker to the reverse proxy. Once added you can access the listed sub-domains
|
|
from your browser, and they will target the reverse proxy.
|
|
|
|
[suite]: ./suites.md |