mirror of
https://codeberg.org/keyoxide/keyoxide-web.git
synced 2024-12-22 14:59:29 -07:00
86 lines
3.8 KiB
Markdown
86 lines
3.8 KiB
Markdown
# keyoxide-web
|
|
|
|
[](https://ci.codeberg.org/repos/5919)
|
|
[](https://codeberg.org/keyoxide/keyoxide-web/src/branch/main/LICENSE)
|
|
[](https://hub.docker.com/r/keyoxide/keyoxide)
|
|
[](https://hub.docker.com/r/keyoxide/keyoxide)
|
|
[](https://fosstodon.org/@keyoxide)
|
|
[](https://opencollective.com/keyoxide)
|
|
|
|
`keyoxide-web` is the web client that powers [keyoxide.org](https://keyoxide.org) and which you can freely host on your own infrastructure.
|
|
|
|
## Hosting keyoxide-web
|
|
|
|
Self-hosting Keyoxide is an important aspect of the project. Users need to trust the Keyoxide instance they're using to reliably verify identities. Making Keyoxide itself decentralized means no one needs to trust a central server. If a friend or family member is hosting a Keyoxide instance, it becomes much easier to trust the instance!
|
|
|
|
### Docker
|
|
|
|
The Docker container allows you to easily self-host the [Keyoxide](https://keyoxide.org) project. To get started, run:
|
|
|
|
```sh
|
|
docker run -d -p 3000:3000 codeberg.org/keyoxide/keyoxide-web:latest
|
|
```
|
|
|
|
Keyoxide will now be available at [http://localhost:3000](localhost:3000).
|
|
|
|
More information available in the [documentation](https://docs.keyoxide.org/guides/self-hosting/).
|
|
|
|
## Local development
|
|
|
|
Install `node` in one of the following ways:
|
|
|
|
- [nix](https://nixos.org/guides/install-nix.html) with [direnv](https://direnv.net/)
|
|
- using [fnm](https://github.com/Schniz/fnm)
|
|
- using [nvm](https://github.com/nvm-sh/nvm)
|
|
- directly from their [website](https://nodejs.org/)
|
|
|
|
Install the dependencies and run the server:
|
|
|
|
```sh
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
The web client will now be available at [http://localhost:3000](localhost:3000).
|
|
|
|
### Using nix
|
|
|
|
Enter a development shell:
|
|
|
|
```sh
|
|
nix develop
|
|
npm run dev
|
|
```
|
|
|
|
Alternatively, start a local server directly:
|
|
|
|
```sh
|
|
nix develop --command bash -c "npm run dev"
|
|
```
|
|
|
|
## Contributing
|
|
|
|
Anyone can contribute!
|
|
|
|
Developers are invited to:
|
|
|
|
- fork the repository and play around
|
|
- submit PRs to [implement new features or fix bugs](https://codeberg.org/keyoxide/keyoxide-web/issues)
|
|
|
|
If you are new to contributing to open source software, we'd love to help you! To get started, here's a [list of "good first issues"](https://codeberg.org/keyoxide/keyoxide-web/issues?q=&type=all&state=open&labels=183598) that you could look into.
|
|
|
|
Everyone is invited to:
|
|
|
|
- find and [report bugs](https://codeberg.org/keyoxide/keyoxide-web/issues/new/choose)
|
|
- suggesting [new features](https://codeberg.org/keyoxide/keyoxide-web/issues/new/choose)
|
|
- [help with translations](https://translate.codeberg.org/projects/keyoxide/)
|
|
- [improve documentation](https://codeberg.org/keyoxide/keyoxide-docs)
|
|
- start using open source software and promote it
|
|
|
|
Please note that this project has a [Code of Conduct](https://codeberg.org/keyoxide/web/src/branch/main/CODE_OF_CONDUCT.md) that all contributors agree to abide when participating.
|
|
|
|
## About the Keyoxide project
|
|
|
|
The Keyoxide project strives for a healthier internet for all and has made its efforts fully [open source](https://codeberg.org/keyoxide). Our [community](https://docs.keyoxide.org/community/) is open and welcoming, feel free to say hi!
|
|
|
|
Funding for the project comes from the [NLnet foundation](https://nlnet.nl/), [NGI0](https://www.ngi.eu/) and the people supporting our [OpenCollective](https://opencollective.com/keyoxide). The project is grateful for all your support.
|