3d312cf3b9
* Check for pnpm in authelia-scripts * Improve husky hooks to check for required apps * Use pnpm in coverage dockerfile * Use pnpm in dev workflow * Stop buildx log truncation * Ignore pnpm lockfile in yamllint * Update versions required for docker and docker-compose in contributing docs
1.5 KiB
| layout | title | nav_order | has_children |
|---|---|---|---|
| default | Contributing | 7 | 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:
$ source bootstrap.sh
Then, start the Standalone suite.
$ 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.
FAQ
What version of Docker and docker-compose should I use?
Here are the versions used for testing in Buildkite:
$ docker --version
Docker version 20.10.8, build 3967b7d
$ docker-compose --version
docker-compose version 1.28.0, 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.