diff --git a/articles/README.md b/articles/README.md new file mode 100644 index 0000000..06a6f72 --- /dev/null +++ b/articles/README.md @@ -0,0 +1,9 @@ +

Official Thunix Wiki.

+ +#### Welcome to the Offical Thunix Wiki! + +      test + +test + +adding some test diff --git a/articles/wiki/unsorted/ansible.md b/articles/wiki/unsorted/ansible.md new file mode 100644 index 0000000..69ac1a8 --- /dev/null +++ b/articles/wiki/unsorted/ansible.md @@ -0,0 +1,74 @@ +man {#man align="center"} +=== + +[NAME](#NAME)\ +[SYNOPSIS](#SYNOPSIS)\ +[DESCRIPTION](#DESCRIPTION)\ +[SEE ALSO](#SEE%20ALSO)\ +[BUGS](#BUGS)\ +[AUTHOR](#AUTHOR)\ + +------------------------------------------------------------------------ + +NAME []() +--------- + +Ansible on Thunix - how we manage the server + +SYNOPSIS []() +------------- + +ansible-pull + +DESCRIPTION []() +---------------- + +We use ansible to manage the servers running the systems and services +for Thunix. Ansible consists of a "playbook" of YAML files, that declare +the state of the system. + +The first step is to clone the repo used to manage the environment: + +git clone git@ttm.sh:thunix/ansible.git (You will need a tidegit account +for this, and a key loaded into your account there) + +From there, the typical github-type workflow is used: + +\* Create a local branch, to track your issue’s changes. + +\* Commit changes to your local branch. + +\* Send a URI pointing to your repo, with branch name to someone with +merge permissions + +Inside of the tildegit interface: + +\* Create a new branch, selecting option to create a branch and pull +request + +\* Make changes in your branch + +\* Update PR + +\* Wait for someone to merge your changes + +Hourly, a job runs that pulls the latest version of the repo, and the +runs ansible-playbook against the playbook. A sudoer can manually run +this job, if desired, and it’s located at /etc/cron.hourly/ansible-pull. + +SEE ALSO []() +------------- + +tildegit.org(8), git(8), ansible-playbook(8) + +BUGS []() +--------- + +No known bugs. + +AUTHOR []() +----------- + +Uber Geek (ubergeek@thunix.net) + +------------------------------------------------------------------------ diff --git a/articles/wiki/unsorted/chat.md b/articles/wiki/unsorted/chat.md new file mode 100644 index 0000000..485fde0 --- /dev/null +++ b/articles/wiki/unsorted/chat.md @@ -0,0 +1,47 @@ +man {#man align="center"} +=== + +[NAME](#NAME)\ +[SYNOPSIS](#SYNOPSIS)\ +[DESCRIPTION](#DESCRIPTION)\ +[BUGS](#BUGS)\ +[SEE ALSO](#SEE%20ALSO)\ +[AUTHOR](#AUTHOR)\ + +------------------------------------------------------------------------ + +NAME []() +--------- + +chat - chat script + +SYNOPSIS []() +------------- + +chat + +DESCRIPTION []() +---------------- + +This is a simple script to launch weechat for new users, and get them +into the correct channel for chat and support. + +BUGS []() +--------- + +\* If you have a customized list of servers in your weechat config +already, this may try to connect you twice, and you’ll have two nicks +going at once, which will be confusing. Once you’ve customized weechat +to your liking, just invoke ’weechat’ or ’weechat-curses’. + +SEE ALSO []() +------------- + +weechat(8) + +AUTHOR []() +----------- + +Uber Geek (ubergeek@thunix.net) + +------------------------------------------------------------------------ diff --git a/articles/wiki/unsorted/contributing.md b/articles/wiki/unsorted/contributing.md new file mode 100644 index 0000000..d422a70 --- /dev/null +++ b/articles/wiki/unsorted/contributing.md @@ -0,0 +1,3 @@ +## Contributing to the wiki + +Just do a PR on [tildegit](https://tildegit.org/thunix/wiki) diff --git a/articles/wiki/unsorted/email.md b/articles/wiki/unsorted/email.md new file mode 100644 index 0000000..12f16f6 --- /dev/null +++ b/articles/wiki/unsorted/email.md @@ -0,0 +1,9 @@ +## Your Thunix Email + +Every thunix account comes with a functional and encrypted email address. This email is the same as your SSH login name. However, you will need to set a password on your thunix SSH account, using the PASSWD command in BASH. Though your SSH account will have a password, this will NOT affect how you log into your account using SSH or an SFTP client, as your public/private key pair will always work. The account password, however, will affect your thunix email address. + +Your email can be accessed in one of three ways: + +1. Running the Mutt email client through your SSH account +2. Logging into your email account from our [web mail](https://www.thunix.net/webmail/) service +3. Through an email client program installed on your computer, using IMAP \ No newline at end of file diff --git a/articles/wiki/unsorted/sandbox.md b/articles/wiki/unsorted/sandbox.md new file mode 100644 index 0000000..4492017 --- /dev/null +++ b/articles/wiki/unsorted/sandbox.md @@ -0,0 +1,2 @@ +## Sandbox +Just a sandbox diff --git a/articles/wiki/unsorted/ssh.md b/articles/wiki/unsorted/ssh.md new file mode 100644 index 0000000..2b4f8b4 --- /dev/null +++ b/articles/wiki/unsorted/ssh.md @@ -0,0 +1,5 @@ +## SSH and Thunix (And magic!) + +When you [sign up](https://www.thunix.net/signup.php) for an account on thunix, you'll be given remote access to a Linux shell server, with web hosting, gopher hosting and email. And because of our [GDPR and privacy policy](https://www.thunix.net/gdpr.php), we take security seriously. This is why we use SSH key pairs to grant access to our server through SSH or SFTP. + +On our signup page, you'll seen an entry for a "Public SSH Key." SSH key pairs work on the basis of having two files; one is a public key that you can send to us when we create your account, while the other is a private key that you keep on your computer, away from public knowledge. \ No newline at end of file diff --git a/articles/wiki/unsorted/thunix.md b/articles/wiki/unsorted/thunix.md new file mode 100644 index 0000000..caf9ed1 --- /dev/null +++ b/articles/wiki/unsorted/thunix.md @@ -0,0 +1,224 @@ +man {#man align="center"} +=== + +[NAME](#NAME)\ +[SYNOPSIS](#SYNOPSIS)\ +[ADMINISTRATORS](#ADMINISTRATORS)\ +[DESCRIPTION](#DESCRIPTION)\ +[Purpose](#Purpose)\ +[Terms of Service](#Terms%20of%20Service)\ +[Architecture](#Architecture)\ +[SEE ALSO](#SEE%20ALSO)\ +[AUTHOR](#AUTHOR)\ + +------------------------------------------------------------------------ + +NAME []() +--------- + +Thunix - a public Linux server + +SYNOPSIS []() +------------- + +ssh thunix.net + +ADMINISTRATORS []() +------------------- + +List of system adminstrators are: + +\* amcclure - Email: amcclure@thunix.net\ +IRC: amcclure/irc.tilde.chat, amcclure/irc.freenode.net + +\* naglfar - Email: naglfar@thunix.net\ +IRC: Naglfar/irc.tilde.chat, Naglfar/irc.freenode.net + +\* ubergeek - Email: ubergeek@thunix.net, ubergeek@yourtilde.com\ +- IRC: ubergeek/irc.tilde.chat, ub3g33k/irc.freenode.net + +\* fosslinux - Email: fosslinux@thunix.net\ +- IRC: fosslinux/irc.tilde.chat + +DESCRIPTION []() +---------------- + +Thunix is a publicly accesible Linux server, running Debian 9, and +managed using ansible playbooks. + +There are many optional things to do on Thunix. There is IRC chat +availble with the weechat client. Most build tools are available to you +as well, to include git, make, gcc, go, python, and perl. Mail facilties +are also available for you to use via alpine, mutt, or even mailx. + +To enter chat, just type ’chat’ and hit enter. You’ll be dropped into +the \#thunix chat room on the irc.tilde.chat network. + +You should create an account at tildegit.org, where Thunix’s git repos +are hosted, to include the system configuration definition files. + +Ansible is the tool we use to configure the systems that comprise +Thunix. Git and ansible are two tools your should familiarize yourself +with. + +Purpose []() +------------ + +The goal of Thunix is to be an open and collaborative environment, +conducive to learning the principles of \*Nix operating systems, +regarding how they work, how to administer them, how to use them, and +how to collaborate using them. + +Thunix tries to adhere to the values and philosophy of the Hacker Ethic +whenever possible. The hacker ethics and beliefs as described by Levy +are: + ++--------------------------+--------------------------+--------------------------+ +| | | \* Access to computers - | +| | | and anything which might | +| | | teach you something | +| | | about the way the world | +| | | works - should be | +| | | unlimited and total. | +| | | Always yield to the | +| | | Hands-On Imperative! | ++--------------------------+--------------------------+--------------------------+ +| | | \* All information | +| | | should be free | ++--------------------------+--------------------------+--------------------------+ +| | | \* Mistrust authority - | +| | | promote decentralization | ++--------------------------+--------------------------+--------------------------+ +| | | \* Hackers should be | +| | | judged by their hacking, | +| | | not criteria such as | +| | | degrees, age, race, sex, | +| | | or position | ++--------------------------+--------------------------+--------------------------+ +| | | \* You can create art | +| | | and beauty on a computer | ++--------------------------+--------------------------+--------------------------+ +| | | \* Computers can change | +| | | your life for the better | ++--------------------------+--------------------------+--------------------------+ + +Thunix will never use proprietary software but users can do that if they +wish. This is something they should avoid however. + +Terms of Service []() +--------------------- + +Nothing is without its rules and regulations; thunix is no exception. +Below are the site’s service terms. Everything in this page should be +clear to everyone who wishes to use thunix’s services; failure to abide +by these terms can result in penalties such as service bans and may +result in legal action against any offending users, depending on the +severity of each case and any other individuals who may have been +affected. Thunix may conduct investigations on any suspected violations, +and we will cooperate with law enforcement agencies with their +investigations. Be sure to read this page carefully and understand it. + +You are responsibe for checking your local mail account from time to +time. This email address is the only one we retain, and as such, any +warnings and notices regarding your account, or service status will be +sent to this account. + ++--------------------------------------+--------------------------------------+ +| | \* Deliberately defacing the | +| | accounts of other users | ++--------------------------------------+--------------------------------------+ +| | \* Deliberately trying to disrupt | +| | thunix’s server | ++--------------------------------------+--------------------------------------+ +| | \* Using thunix as a launch pad for | +| | disrupting other servers | ++--------------------------------------+--------------------------------------+ +| | \* Using thunix to impersonate other | +| | websites and businesses for criminal | +| | purposes | ++--------------------------------------+--------------------------------------+ +| | \* Storing/distributing pornography | +| | of any genre and medium (especially | +| | child pornography) | ++--------------------------------------+--------------------------------------+ +| | \* Storing/distributing content that | +| | defames any individual | ++--------------------------------------+--------------------------------------+ +| | \* Promoting racial, ethnic, | +| | religious, political and other forms | +| | of bigotry | ++--------------------------------------+--------------------------------------+ +| | \* Storing/distributing, promoting, | +| | or encouraging use of | +| | pirated/cracked software, license | +| | keys, license/registration | +| | circumvention programs, or any | +| | questionable programs/scripts that | +| | can risk causing unauthorized | +| | modifications, or disrupts network | +| | services for any programs or | +| | devices. | ++--------------------------------------+--------------------------------------+ +| | \* Mining cryptocurrencies | ++--------------------------------------+--------------------------------------+ +| | \* Spamming on any forums, mailing | +| | lists, irc channels, newsgroups, | +| | etc. | ++--------------------------------------+--------------------------------------+ +| | \* Leaking or publishing any user’s | +| | or individual’s personal information | +| | without that person’s consent. | ++--------------------------------------+--------------------------------------+ + +Copyright infringement is not allowed on thunix, and we will not allow +any illegal content to be distributed. It’s also expected that all users +respect the copyrights of those who produce original content of any kind +and only share if the author or license grants you permission. Content +hosted on accounts used for external file storage must also follow +copyright law. + +If you want to request for content you own the copyright for to be +removed from thunix, please refer to our abuse reporting page +(https://www.thunix.net/abuse.php). In the email, please identify who +you are, if you are the copyright holder or legally representing them, +the exact files you want removed with links to the files and infringed +content, and contact information such as phone numbers or a reply-to +email address. + +Users that repeatedly violate the Terms of Service will have their +account removed. Depending on the degree of the offense, their account +may be removed immediately. These terms also apply to communication +services such as forums, mailing lists, irc channels, newsgroups, and +any other service either hosted on or used for thunix. If you come +across anything that violates the terms of service, please let us know +with the abuse reporting page (https://www.thunix.net/abuse.php). + +Architecture []() +----------------- + +The Thunix system consists of one server, running Debian 9, which runs +inside of an LXD container. This allows for an out-of-band +administration of the host, in case of configuration-gone-awry. + +Hourly, thunix reaches out to tildegit, pull down the latest version of +the configuration, and run the configuration tool, ensuring it is in a +known, and easily replicable state. + +All repos for system configuration, Thunix-supplied/ran code is hosted +on tildegit.org. Thunix users are recommended to create accounts on +tildegit, and contribute pull requests to make their desired changes to +the system, or very minimally, submit issues for problems and/or +requests. + +SEE ALSO []() +------------- + +ssh(8), weechat(8), git(8), make(8), gcc(8), go(8), python(8), perl(8), +alpine(8), mutt(8), mailx(8), ansible-playbook(8), tildegit.org(8) + +AUTHOR []() +----------- + +Uber Geek (ubergeek@thunix.net) amcclure (amcclure@thunix.net) + +------------------------------------------------------------------------ diff --git a/articles/wiki/unsorted/tildegit.org.md b/articles/wiki/unsorted/tildegit.org.md new file mode 100644 index 0000000..d707b38 --- /dev/null +++ b/articles/wiki/unsorted/tildegit.org.md @@ -0,0 +1,61 @@ +man {#man align="center"} +=== + +[NAME](#NAME)\ +[SYNOPSIS](#SYNOPSIS)\ +[DESCRIPTION](#DESCRIPTION)\ +[SEE ALSO](#SEE%20ALSO)\ +[BUGS](#BUGS)\ +[AUTHOR](#AUTHOR)\ + +------------------------------------------------------------------------ + +NAME []() +--------- + +tildegit.org - a public web based source repository for the tildeverse + +SYNOPSIS []() +------------- + +https://tildegit.org + +DESCRIPTION []() +---------------- + +Tildegit is a web based source control system available for the +tildeverse, that runs gitea. Thunix uses tildegit.org for all source +control. + +The following git repos are used: + +\* ansible (https://tildegit.org/thunix/ansible) This repo stores the +configuration spec for all machines comprising Thunix. The repo consists +of declarative YAML files that describes the state the machines should +be in. + +\* www (https://tildegit.org/thunix/www) This repo stores the source +code that makes up the https:/thunix.net website. It’s mostly php. + +\* documentation (https://tildegit.org/thunix/documentation) This repo +stores the man pages, and accompanying documentation for the system. + +\* thunix\_gopher (https://tildegit.org/thunix/thunix\_gopher) This repo +houses our gopher hole + +SEE ALSO []() +------------- + +git(8), ansible(8) + +BUGS []() +--------- + +No known bugs. + +AUTHOR []() +----------- + +Uber Geek (ubergeek@thunix.net) + +------------------------------------------------------------------------