User:Kiara/Memo

Using the plotters

Emulation is nice to save energy and prevent redundancy, you don't need a machine for every project because you can install that virtual machine on several systems. It is really convenient for testing purposes

-------------------------------
Get a virtual machine
-------------------------------

• Install virtualbox
• Create a New virtual machine
  • Give it a name and choose a folder to install the virtual machine in
  • ISO image = the Linux distro you want (look for it on distrowatch)
    • Debian: get it from debian.org > download > amd64.iso (arm64 for newest Macs)
    • Type is Linux
    • Subtype corresponds to the one chosen (Debian)
    • Version is the version of Debian
  • Set username and password
  • Choose the settings for system capacity and memory usage
  • Finish

-------------------------------
Get a graphical interface
-------------------------------

su
//enter password
apt install kde-plasma-desktop

-------------------------------
Print with pen plotters
-------------------------------

• Install python

su
//enter password
apt install python3.12-venv //or python3.11-venv

• Run venv

python3 -m venv
source bin/activate

• Install chiplotle

pip install chiplotle3

• Run chiplotle

chiplotle3

• Config file

• Print!

-------------------------------
Cowsay fortune telling
-------------------------------

sudo apt install cowsay
sudo apt install fortune
fortune | cowsay

To check the animal/character options of cowsay:

cowsay -l

Print cowsay fortune prompts into a txt file so you can save them, choose from them and copy/paste them elswhere (such as inkscape to print them with the plotters <3)

fortune | cowsay -f duck >> cowsay-fortunes.txt

Server

Installing Virtual Box

Virtual Box runs a virtual machine on a computer and allows to install and run a Linux distro.

To install it:

• Download Virtual Box https://www.virtualbox.org/wiki/Downloads
• Get the iso image of Debian https://www.debian.org/distrib/
• Set up the virtual machine using the "New" button (in Virtual Box)
• Follow the debian steps of configuration
  • domain name: leave empty
  • password: choose a password to log in you user
  • if it installs GNOME as Graphic User Interface by default and you don't like it, I recommend KDE Plasma that you can install by running the following commands:

su -
#enter your password
nano /etc/group
#look for sudo and add your username at the end of the line
exit
#log out and log in again, reopen the terminal and type:
sudo apt install kde-plasma-desktop

Then you can follow the steps from this website

Run a web server on the virtual machine

sudo apt install nginx php 8.2

If you wish to run a personal server on a Linux machine (not virtual): When installing Linux, in the "software selection (gui)" window, pick:

• web server
• ssh server
• standard system utilities

After installation complete, remove usb stick and wait to be prompted the username and password

Installation: mastodon instance

SSH to Debby

ssh xpub@145.24.152.64 //the hub IP is 10.0.0.19
enter password

Jump user

get your jump.pub ssh key from your local .ssh folder
paste the key into /.ssh/authorized_keys on Debby
add also your own personal .pub ssh key (not linked to cerealbox) in the same file

Edit the ssh config file

In your local .ssh folder, open the config file and duplicate the last cerealbox entry, then update information for Debby as follows:

Host debby
Hostname 10.0.0.19
User xpub
ProxyJump xvm_jump
Identityfile ~/.ssh/id_rsa [this last part should be the name of your personal ssh key file, mine is id_rsa but yours might be different]

for the local address:

Host debby_local
Hostname 145.24.152.64
User xpub
Identityfile ~/.ssh/id_rsa

Packages installed

• tmux

Launch tmux:

one writes tmux new

others write tmux attach

Mastodon glitch-soc installation

Installation guide
This guide assumes a bunch of things are already installed, but if you don't have them on your system you will have to install them. We provide here additional guidance because we don't have anything installed. In order to use the installation commands from the guide, we need to log into the root with su and then run the commands

• After enabling corepack, the documentation doesn't say it but you should install yarn by just writing yarn in the terminal

adduser doesn't work? here's how to resolve it:

Unhide the adduser command using the following command:

sudo update-alternatives --install /bin/adduser adduser /usr/sbin/adduser 20

then run again

adduser --disabled-password mastodon

• To login into the mastodon account for the Setting up Mastodon step, use:

su mastodon

• When installing Ruby:
  

the last git command should be ran alone

git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build

install bundler by running (in su mode)

apt install bundler
apt install gem

then run the installation commands:

bundle config deployment 'true'
bundle config without 'deployment test'
bundle init
cd
.bundle
nano config

comment out the BUNDLE_FROZEN=: "true" by adding # in front of it

bundle install -j$(getconf _NPROCESSORS_ONLN)
yarn install

• Install the rails gem with

gem install rails

• Then run

RAILS_ENV=production rails mastodon:setup

• In the SSL Certificate step:
  

Use the example.com commands, they will be editable later, but you should already have a (sub)domain name registered.
If encountering "An unexpected error" when trying to generate certificate, run

apt install python3-certbot-nginx

If you get an error while running systemctl restart nginx to apply changes, follow these steps (in progress)

cat /var/log/nginx/error.log
journalctl 
/etc/nginx/sites-enabled
nano mastodon

Putting a server online

Do some Port Forwarding from the router's administration page to serve all internet traffic on the port 80 (for http) or 443 (https).
If you move out, the IP address changes so you have to update it in the DNS Zone...

To access you server's DNS Zone:

this is done from your registrar's admin panel

Subdomains

They can have their own CNAME record

RSS Feed

template.rss

To write an RSS feed manually

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
   <channel>
      <title>The Title</title>
      <link>The link to your rss feed</link>
      <description>Your description goes here</description>
      
      <item>
        <title>Item Title</title>
        <description>Item description</description>
        <link></link>
        <pubDate>Wed, 25 May 2025 12:00:00 GMT</pubDate>
      </item>
   </channel>
</rss>

Generate an RSS feed for a handmade website

Put the URL of the website in https://rss-bridge.org/
Add a <a> tag in your website redirecting to the feed generated by the bridge website

Declaring fees to get a refund from HR

🤫🤫🤫🤫🤫