manuelly new lines are useless; markdown and html will do it

Signed-off-by: Marek Küthe <m.k@mk16.de>
This commit is contained in:
Marek Küthe 2023-01-02 01:01:36 +01:00
parent 90c2cc647b
commit ac1ebb5832
No known key found for this signature in database
GPG Key ID: 7E869146699108C7
4 changed files with 21 additions and 66 deletions

View File

@ -1,14 +1,10 @@
# Getting started # Getting started
Firstly we'd like to say that we're glad you'd like to join our network and Firstly we'd like to say that we're glad you'd like to join our network and greater community! This document will provide you with the directions you will need to follow in order to get connected.
greater community! This document will provide you with the directions you
will need to follow in order to get connected.
## Steps to follow ## Steps to follow
Below you can follow the steps one-by-one to get yourself familiar with our Below you can follow the steps one-by-one to get yourself familiar with our practices and inner-workings and by the end you should have all the information and configuration details needed to get connected!
practices and inner-workings and by the end you should have all the information
and configuration details needed to get connected!
1. [Rules](rules) 1. [Rules](rules)
* We have **few** but **strict** rules nonetheless * We have **few** but **strict** rules nonetheless

View File

@ -11,65 +11,40 @@
<img src="./img/map.png" class="floating_right" alt="CRXN logo"> <img src="./img/map.png" class="floating_right" alt="CRXN logo">
CRXN stands for **C**ommunity **R**un e**X**pansive **N**etwork. It's a computer network _run by the community for the community_. CRXN stands for **C**ommunity **R**un e**X**pansive **N**etwork. It's a computer network _run by the community for the community_. We provide an IPv6 (that's the freshest Internet Protocol out there to date) and on CRXN anything that can speak IPv6 will be able to function correctly - a network without borders! We are focused with having a network that really focuses on the "end-to-end" principal of IP - that is to say that if you want to run something and make it available to other then you won't have to worry about NAT-traversal, port forwarding, lack of raw IP support and all the other non-sense that IPv4 created (due to lack of addresses).
We provide an IPv6 (that's the freshest Internet Protocol out there to date) and on CRXN anything that can speak IPv6
will be able to function correctly - a network without borders! We are focused with having a network that really focuses
on the "end-to-end" principal of IP - that is to say that if you want to run something and make it available to other then
you won't have to worry about NAT-traversal, port forwarding, lack of raw IP support and all the other non-sense that IPv4
created (due to lack of addresses).
Compared to the clearnet (normal Internet) there isn't much fuss involved around getting Compared to the clearnet (normal Internet) there isn't much fuss involved around getting a network ID assigned to you and so forth, we truly are for the community and all our members take some of their own time to work on their network and the greater CRXN inter-network as a whole.
a network ID assigned to you and so forth, we truly are for the community and all our members take some of their own time
to work on their network and the greater CRXN inter-network as a whole.
It's a great place to test out new protocols, networking projects, play games, exchange ideas and learn about networking, It's a great place to test out new protocols, networking projects, play games, exchange ideas and learn about networking, routing and network sub-systems themselves. You also get to learn how CRXN is put together which is a great way to learn networking with those that run networks already themselves.
routing and network sub-systems themselves. You also get to learn how CRXN is put together which is a great way to learn
networking with those that run networks already themselves.
## Our goals ## Our goals
The network has a few goals that we always want to maintain as to not lose our allure: The network has a few goals that we always want to maintain as to not lose our allure:
1. Be a network for learning 1. Be a network for learning
* We don't want to shun people away from using some new * We don't want to shun people away from using some new routing protocol as it might be cool and interesting to learn
routing protocol as it might be cool and interesting to
learn
2. Be reliable 2. Be reliable
* Of course when learning people should also make sure * Of course when learning people should also make sure their routers don't just accept any route without making sure its valid - hence network operators should make sure their networks operate even when some are causing mayhem (malicious or learning by trial and error)
their routers don't just accept any route without making
sure its valid - hence network operators should make sure
their networks operate even when some are causing mayhem
(malicious or learning by trial and error)
* Also shouldn't be painfully slow * Also shouldn't be painfully slow
3. Diverse routing 3. Diverse routing
* We want to try out protocols like **ospf**, **babel**, **bgp** * We want to try out protocols like **ospf**, **babel**, **bgp** and so on and so forth
and so on and so forth * We want to build a network out of a mix and match of these all working in harmony together
* We want to build a network out of a mix and match of these all
working in harmony together
* Monocultures suck! * Monocultures suck!
4. Usable 4. Usable
* We have DNS, we have voice chat servers and we have IRC (we * We have DNS, we have voice chat servers and we have IRC (we even have gaming!) but we can always do with much **much more**!
even have gaming!) but we can always do with much **much more**! * We want the users, _you_, to make the network usable for your needs - who knows it might provide a service that helps out someone else
* We want the users, _you_, to make the network usable for your
needs - who knows it might provide a service that helps out
someone else
5. Peering 5. Peering
* We want people to setup redundant links using whatever protocols * We want people to setup redundant links using whatever protocols they want, be it **wireguard**, **GRE**, **fastd** etc.
they want, be it **wireguard**, **GRE**, **fastd** etc.
* We want there to be interesting links and diversity * We want there to be interesting links and diversity
6. _Chaos and Order_ 6. _Chaos and Order_
* The network should never stop experimenting * The network should never stop experimenting
* But it should have 99% uptime and safety fallbacks * But it should have 99% uptime and safety fallbacks
* If you want to experiment - then go ahead and try cause * If you want to experiment - then go ahead and try cause as little disruption as possible
as little disruption as possible * If you run a node - make it secure - sign routes etc. to prevent others from experimenting from messing your network up
* If you run a node - make it secure - sign routes etc.
to prevent others from experimenting from messing your
network up
We aim to create a more open Internet available to everyone and a place to learn about IP routing and networking in general. We aim to create a more open Internet available to everyone and a place to learn about IP routing and networking in general.
We don't use any particular tooling, the only thing that is standard is the IPv4 and IPv6 part. What tunnelling software, physical We don't use any particular tooling, the only thing that is standard is the IPv4 and IPv6 part. What tunnelling software, physical mediums or routing daemon you choose to use is up to you - this falls in line with our _open_ ethos.
mediums or routing daemon you choose to use is up to you - this falls in line with our _open_ ethos.
## About the network ## About the network
@ -77,11 +52,9 @@ A few details about the network.
### Protocol support ### Protocol support
We only use IPv6 on CRXN because it has many features, such as link-local addresses, that make We only use IPv6 on CRXN because it has many features, such as link-local addresses, that make setting up dynamic routing protocols near-zero-config.
setting up dynamic routing protocols near-zero-config.
It's also the modern way of the Internet and means you will get a large space of addresses It's also the modern way of the Internet and means you will get a large space of addresses assigned to you.
assigned to you.
### The range ### The range
@ -97,9 +70,7 @@ We keep track of allocations on a Git-based repository called [_EntityDB_](https
### Joining the network ### Joining the network
Does it sound interesting enough for you already? Want to get connected? Then head on over Does it sound interesting enough for you already? Want to get connected? Then head on over to our [Getting started](getting-started/) section where you can find all the guides you need in order to get connected, follow the rules and have fun!
to our [Getting started](getting-started/) section where you can find all the guides you need in order to get connected,
follow the rules and have fun!
--- ---

View File

@ -49,8 +49,6 @@ Hackint IRC: `mark22k`
### Rany `~rany` ### Rany `~rany`
<!-- <img src="people/rany.png"> -->
Administer of EntityDB. Administer of EntityDB.
Roles: EntityDB Roles: EntityDB
@ -61,8 +59,6 @@ Matrix: `@rany:fairydust.space`
### Alex Denes `~caskd` ### Alex Denes `~caskd`
<!-- <img src="people/caskd.png"> -->
European CRXN adminstration, runs the CRXN DNS root name server. European CRXN adminstration, runs the CRXN DNS root name server.
Roles: Network services, CRXN DNS Roles: Network services, CRXN DNS

View File

@ -2,23 +2,15 @@
## Enabling forwarding ## Enabling forwarding
We will be setting up the machine that runs bird as a router so therefore We will be setting up the machine that runs bird as a router so therefore we need to make your Linux kernel's network stack not drop IPv6 packets that it receives (addressed to it via Ethernet) but are not addressed to it via IPv6 address - in other words it must try do something with these packets, namely attempt to forward them one hop closer to their initial destination.
we need to make your Linux kernel's network stack not drop IPv6 packets
that it receives (addressed to it via Ethernet) but are not addressed to
it via IPv6 address - in other words it must try do something with these packets,
namely attempt to forward them one hop closer to their initial destination.
Enabling forwarding on all interfaces can be achieved as follows (you will need Enabling forwarding on all interfaces can be achieved as follows (you will need to be root):
to be root):
```bash ```bash
echo 1 > /proc/sys/net/ipv6/conf/all/forwarding echo 1 > /proc/sys/net/ipv6/conf/all/forwarding
``` ```
However, after reboot it won't be saved and will go back to its defaults. Therefore However, after reboot it won't be saved and will go back to its defaults. Therefore what you need to do is to enable forwarding on boot-up, this can be done by adding an additional line to your `/etc/sysctl.conf` (which holds a bunch of these statements), it should look like this:
what you need to do is to enable forwarding on boot-up, this can be done by
adding an additional line to your `/etc/sysctl.conf` (which holds a bunch of
these statements), it should look like this:
```bash ```bash
net.ipv6.conf.all.forwarding=1 net.ipv6.conf.all.forwarding=1