forked from thunix/wiki
v002_01: [Draft U2D]
Brought Drafts up-2-date on the bitb repo.
This commit is contained in:
parent
5d468882d6
commit
f0a7a3dce0
|
@ -0,0 +1,9 @@
|
|||
<center><h1>Official Thunix Wiki.</h1></center> <!-- Make Image?-->
|
||||
<!-- Buttons Here... -->
|
||||
#### Welcome to the Offical Thunix Wiki!
|
||||
|
||||
test
|
||||
|
||||
test
|
||||
|
||||
adding some test
|
|
@ -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)
|
||||
|
||||
------------------------------------------------------------------------
|
|
@ -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)
|
||||
|
||||
------------------------------------------------------------------------
|
|
@ -0,0 +1,3 @@
|
|||
## Contributing to the wiki
|
||||
|
||||
Just do a PR on [tildegit](https://tildegit.org/thunix/wiki)
|
|
@ -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
|
|
@ -0,0 +1,2 @@
|
|||
## Sandbox
|
||||
Just a sandbox
|
|
@ -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.
|
|
@ -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)
|
||||
|
||||
------------------------------------------------------------------------
|
|
@ -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)
|
||||
|
||||
------------------------------------------------------------------------
|
Loading…
Reference in New Issue