Skip to content

Commit

Permalink
Changes
Browse files Browse the repository at this point in the history
  • Loading branch information
blaubaer committed Aug 27, 2024
1 parent 704e8a3 commit fc2657a
Show file tree
Hide file tree
Showing 4 changed files with 14 additions and 6 deletions.
12 changes: 10 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,10 @@ Bifröst (spoken as "Bee-frest"), is an advanced SSH server. It can be used as a

## TOC

* [Use-cases](doc/usecases.md)
* [Features](#features)
* [Getting started](#getting-started)
* [Configuration](doc/configuration.md)
* [Status](#status)
* [License](LICENSE)
* [Code of Conduct](CODE_OF_CONDUCT.md)
Expand Down Expand Up @@ -45,11 +47,11 @@ It can also automatically clean up these users as they're no longer needed, for
```shell
# Syntax
curl -sSLf https://github.com/engity-com/bifroest/releases/download/<version>/bifroest-<os>-<arch>-<edition>.tgz | sudo tar -zxv -C /usr/bin bifroest

# Example
curl -sSLf https://github.com/engity-com/bifroest/releases/download/v1.2.3/bifroest-linux-amd64-extended.tgz | sudo tar -zxv -C /usr/bin bifroest
```
2. Configure Bifröst. For example download the demo configuration and adjust for your needs (see [our demo configuration](doc/configurations/demo.yaml) for the documentation about it):
2. Configure Bifröst. For example download the demo configuration and adjust for your needs (see [documentation of configuration](doc/configuration.md) for the documentation about it):
```shell
sudo mkdir -p /etc/engity/bifroest/
sudo curl -sSLf https://raw.githubusercontent.com/engity-com/bifroest/main/doc/configurations/sshd-dropin-replacement.yaml -o /etc/engity/bifroest/configuration.yaml
Expand Down Expand Up @@ -80,11 +82,17 @@ To enable Bifröst to run at every server start where [systemd](https://wiki.arc
sudo systemctl start bifroest.service
```

### What's next?

Read [Use-Cases](doc/usecases.md) and [the configuration documentation](doc/configuration.md) to see what you can do more with Bifröst.

## Status

This project is currently under development. The application is stable ([file a bug if you find one](https://github.com/engity-com/bifroest/issues/new/choose)), but the configuration/command/API structure needs improvement.

## More topics
* [Use-Cases](doc/usecases.md)
* [Configuration](doc/configuration.md)
* [License](LICENSE)
* [Code of Conduct](CODE_OF_CONDUCT.md)
* [Contributing](CONTRIBUTING.md)
3 changes: 3 additions & 0 deletions doc/configuration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Engity's Bifröst Configuration

Currently, please see [our demo configuration](configurations/demo.yaml) for details how to configure Bifröst.
3 changes: 0 additions & 3 deletions doc/configurations/README.md

This file was deleted.

2 changes: 1 addition & 1 deletion doc/usecases.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Engity's Bifröst Use-cases

As Bifröst is very flexible how it can be configured (see [configuration documentation](configurations/README.md)), here some use-cases which can be fulfilled by it:
As Bifröst is very flexible how it can be configured (see [configuration documentation](configuration)), here some use-cases which can be fulfilled by it:

1. [**Off**-board users within 15 minutes of the organization](#offboard)
2. [**On**-board users within 15 minutes in the organization](#onboard)
Expand Down

0 comments on commit fc2657a

Please sign in to comment.