Update Etherpad

2026-10-02T15:01:00Z

Manetta:

Update Etherpad

2026-10-02T14:55:26Z

Manetta:

Services on CC

2026-10-02T14:54:00Z

Manetta: /* etherpad */

==debian==

* currently running latest stable: debian 13 (trixie)
* sources: /etc/apt/sources.list.d/debian.sources

<pre>
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware non-free contrib
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware non-free contrib
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
</pre>

==etherpad==

installation log: [[Install Etherpad-lite]]<br>
how to update etherpad: [[Update Etherpad]]

===installed===

/opt/etherpad/

runs as user <code>etherpad</code>

===database===

sqlite

* 878MB on 7 Nov 2025
* 917MB on 11 Dec 2025
* 942MB on 23 Jan 2026
* 1.2G on 2 Oct 2026

===systemd===

sudo systemctl status etherpad
sudo systemctl start etherpad
sudo systemctl stop etherpad
sudo systemctl restart etherpad

<pre>
[Unit]
Description=etherpad (real-time collaborative document editor)
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
#WorkingDirectory=/opt/etherpad
Environment=NODE_ENV=production
#ExecStart=pnpm run prod
ExecStart=/bin/sh /opt/etherpad/bin/run.sh
Restart=always

StandardOutput=append:/var/log/etherpad/etherpad.log
StandardError=append:/var/log/etherpad/etherpad-error.log

[Install]
WantedBy=multi-user.target
</pre>

===logs===

sudo tail -f /var/log/etherpad/etherpad.log
sudo tail -f /var/log/etherpad/etherpad-error.log

===backups===

* crontab: every night at 5.55 <code>/opt/etherpad/etherpad.db</code> is copied to <code>/opt/etherpad/etherpad_backup.db</code> (just in case)

==mediawiki==

/var/www/wiki/

* php: php8.4
* database: mariadb
* installation log: [[Migrate Mediawiki]]

===nginx===

Followed this for the nginx config: https://www.mediawiki.org/wiki/Manual:Short_URL/Nginx

===backups===

backups through crontab:

# every night at 3:33
33 3 * * * mysqldump --user=wiki --password=XXX wikidb > /var/www/html/wiki/ wikidb_backup.sql
33 3 * * * mysqldump --user=wiki --password=XXX wikidb --xml > /var/www/html/wiki/wikidb_backup.xml

==octomode==

/opt/octomode/

* flask application
* runs on port 3333
* /etc/systemd/system/octomode.service
* installation log: [[Octomode]]

<pre>
[Unit]
Description=Collective PDF rendering environment
After=network.target

[Service]
User=octomode
WorkingDirectory=/var/www/octomode
ExecStart=/usr/bin/make action
Restart=always
StandardOutput=append:/var/log/octomode/octomode.log
StandardError=append:/var/log/octomode/octomode.log

[Install]
WantedBy=multi-user.target
</pre>

==wiki-to-print==

/opt/wiki-to-print/

* flask application
* runs on port 4444
* /etc/systemd/system/wiki-to-print.service
* currently running with gunicorn, timeout turned off (after the server move the application timed out on larger documents)
* installation log: [[How to install wiki-to-print?]]

<pre>
[Unit]
Description=wiki-to-print
After=network.target

[Service]
User=wikitoprint
WorkingDirectory=/opt/wiki-to-print/wiki-to-print/
ExecStart=/usr/bin/make server
Restart=always
StandardOutput=append:/var/log/wiki-to-print/wiki-to-print.log
StandardError=append:/var/log/wiki-to-print/wiki-to-print.log

[Install]
WantedBy=multi-user.target
</pre>

==cobbled-paths==

...

==nginx==

/var/www/html/
/home/manetta/public_html/
/home/simoon/public_html/

===home folders===

<pre>
# user directories!! public_html folders
location ~ ^/~(.+?)(/.*)?$ {
add_header Access-Control-Allow-Origin *;
alias /home/$1/public_html$2;
index index.html index.htm;
autoindex on;
}
</pre>

For the public_html folders to work after a fresh install, the permissions of home folders need to be adjusted (??):

sudo chmod 755 /home/*

==certbot==

auto-renewal through crontab:

# every night at 04:44
44 4 * * * certbot renew --pre-hook "systemctl stop nginx" --post-hook "systemctl start nginx" --quiet

[[Category:Sysadmin]]

2026-07-08T10:17:11Z

Manetta:

==Web folklore tools==

edit this list here: [[Web folklore tools]]

{{:Web_folklore_tools}}

==8-bit Home computer tools==
{{Special:PrefixIndex/Typesetting tools/}}

==Serious typesetting tools==

edit this page here: [[Typesetting tools]]

plus, a list of historic typesetting tools: [[Typesetting tools/Timelines]]

{{:Typesetting tools}}

==Image editing tools==

* https://imagemagick.org

Dithering tools:

* https://www.stochaster.org/
* https://www.evilmadscientist.com/2012/stipplegen2/
* https://beyondloom.com/tools/ditherpaint.html

==Other lists!==

* https://tinytools.directory/ → zines/books + print
* https://polytype.dev/ (a rosetta's stone for typesetting tools, quick demo's of many different typesetting tools)
* https://radicalweb.design/recherche/websites/ by Julien Bidoret
* https://ourcollaborative.tools/en/projects EU funded research project [https://www.citedudesign.com/en/a/digital-tools-for-creative-collaboration-1705 Digital Tools for Creative Collaboration] by [https://u-r-n.io/fr random(lab)] at EDADSE in St-Etiène/Lyon icw [https://www.artun.ee EKA], [https://www.hfg-gmuend.de/ HfG] and [https://beda.org/ BEDA] (2020-2023)

Typesetting tools

2026-07-08T10:16:54Z

Manetta:

2026-03-25T21:43:35Z

Manetta: /* Made with Octomode */

[[File:Rwx-octo5.svg|200px]]
[[File:Read-write-execute-octo-mode.png|200px]]
[[File:Octo-hands.png|200px]]

Octomode is a collective editing space for PDF making, using Etherpad, Paged.js and Flask.

Inspired by the multi-centered, tentacular cognition capabilities of the octopus, we imagined a space in which the artificial boundaries of writing and design can be crossed; where writing, editing and designing can be done in one environment simultaneously, allowing the format to influence the matter and vice-versa.

→ '''URL''': https://cc.practices.tools/octomode/<br>
→ '''git repo''': https://git.vvvvvvaria.org/CC/octomode

__TOC__

==Ongoing circulations==

Octomode is strongly relying on (Ether)pad and shared habits of collective note taking in such collaborative environments. In the end, octomode is just a combination of a few free software tools, and we like to think of octomode as a boilerplate, that can be re-configured and re-transformed into other possible environments. It strongly learned from the inspiring work of the following projects:

* [http://osp.kitchen/tools/ethertoff/ Ethertoff] by OSP
* [https://networksofonesown.constantvzw.org/ Etherbox] by Constant
* [https://gitlab.constantvzw.org/aa/etherdump etherdump] by Michael Murtaugh
* [https://relearn.be/2015/ the local network + etherpad setup] during Relearn 2015
* [https://calibre.constantvzw.org/book/34 The Techno-Galactic Guide to Software Observation] by Constant

Octomode is published under [https://git.vvvvvvaria.org/varia/octomode/src/branch/master/LICENSE.txt CC4r]: please feel free to use, change, transform and republish into many directions, within the limits of the conditions formulated by the COLLECTIVE CONDITIONS FOR RE-USE (CC4r) license.

{| class="wikitable"
|-
! octomode instance !! maintained by !! version !! features !! code !! context
|-
| https://cc.practices.tools/octomode/ || [https://cc.practices.tools Creative Crowds (CC)] || CC || main features || https://git.vvvvvvaria.org/CC/octomode || The CC octomode instance, used by us and a network of peers around us, including OSP, XPUB students, Pibliotheque, Varia and others; used for the making of zines, publications which are often personal projects, workshop outputs or sometimes also commissioned work.
|-
| https://circulations.constantvzw.org/octomode/ || [https://constantvzw.org/ Constant] || technodisobedience || main features <br>+ RISO color seperation, epub export, markdown import || https://git.vvvvvvaria.org/CC/octomode/src/branch/technodisobedience/ || Constant's octomode instance as part of their SPLINT 5-year research trajectory and SPLINTER server, used for the making of zines, EPUBs and annual publications that document all their activities of that year, such as [https://calibre.constantvzw.org/book/207 Techno-disobedience] published in December 2023 and [https://constantvzw.org/site/Zine-launch-Otherwordly-Communications.html Otherworldly Communications zine] published in March 2026.
|-
| https://octomode.hackersanddesigners.nl || [https://hackersanddesigners.nl/ H&D] || CC || main features || https://github.com/hackersanddesigners/octomode (fork, no additional changes) || The octomode instance of Hackers & Designers, used to make publications such as [https://hackersanddesigners.nl/hd-bulletin-6.html HD Bulletin 6] + [https://hackersanddesigners.nl/hd-bulletin-7.html HD Bulletin 7]. Octomode was also used during a workshop at one of the HD summercamps, but I can't find it back sadly.
|-
| https://octomode.vvvvvvaria.org || [https://varia.zone varia] || CC || main features || https://git.vvvvvvaria.org/varia/octomode || This was octomode's first URL! Currently it's pointing to the Varia octomode instance, used by Varia members to make the SomeTimes (edition [https://varia.zone/en/2022/sometimes-af-en-toe/ 1] [https://varia.zone/en/2024/sometimes5/ 5] [https://varia.zone/en/2025/some-times-6/ 6]), write funding applications and reports, make zines and other things.
|-
| https://hub.vvvvvvaria.org/rosa/octomode/ || [https://varia.zone/ATNOFS/ ATNOFS] || CC || main features || https://git.vvvvvvaria.org/varia/octomode || Octomode is part of Rosa's ''resonance board'', the landing page of this traveling feminist server: ''The resonance board is a shared space which gathers and folds pads, messages and files hosted on rosa. On the resonance board you can start a new pad, use octomode, use the shared ile system, traverse the list of pads already created, read messages on the folding board, and browse the files that have been uploaded to the chapters folder.'' ([https://zoiahorn.anarchaserver.org/wp-content/uploads/2023/03/ATNOFS-screen.pdf#page=9 link])
|-
| https://lepa.hackersanddesigners.nl/ || [https://hackersanddesigners.nl/ H&D] || Learning Palestine || main features <br>+ Markdown cheatsheet, [https://www.npmjs.com/package/ep_markdown_toc Etherpad table of content plugin] ([https://etherpad.hackersanddesigners.nl/p/ep_plugins documented here]), impositioned PDF export || || A custom Octomode setup for the group [https://learningpalestine.net/ Learning Palestine], to support their (re)publishing efforts of texts ''"to disseminate knowledge on the history of the ongoing struggle for justice, liberation, and freedom of Palestine and the Palestinian People"'', outside of the hands of corporate platforms. At first they explored ways to do so without corporate social media platforms, but then also wanted to step away from corporate design tools such as Adobe InDesign. The project was presented during a [https://hackersanddesigners.nl/bulletin-7-launch-at-fort-van-sjakoo.html HD Bulletin launch] at [https://sjakoo.nl/ Het Fort van Sjakoo] in June 2025.
|-
| https://zine.luddite.tools/ || [https://luddite.tools/ The Luddite Academy/David Benque] || CC || main features <br>+ [https://codeberg.org/luddite-academy/octomode/commit/7eebbd1098f44de743a97394468b49672bf368d7 patch for not working Etherpad URLs] || https://codeberg.org/luddite-academy/octomode || ''The project was [is] titled "The Luddite Academy" and proposed to bring the current resurgence of luddite theory and praxis to bear on the university's digital arts and humanities departments.'' ([https://post.lurk.org/@diagram_studies/115768866079004997 link])
|}

==How to use octomode?==

If you want to work collectively on a PDF, you can make a new octomode environment here: https://cc.practices.tools/octomode/.

You can write any name of in the input field, this will be the name of the new octomode environment and pads that are used.

'''Note''': When working with multiple people on one PDF it is recommended to use the same browser. CSS rules are rendered slightly differently on different browsers.

Working in octomode includes:

* <code>pad</code>: all materials for the PDF are collected here. (written in Markdown)
* <code>stylesheet</code>: all CSS rules for the PDF are collected here (written in CSS)
* <code>html</code>: render the lay out as a HTML (rendered with PyPandoc)
* <code>pdf</code>: render the lay out as a PDF (rendered with Paged.js)

When creating a new environment, a few things happen:

* a pad is created for collecting the materials of your PDF. The name of the octomode environment will become the name of this pad. For example: <code>https://cc.practices.tools/pad/p/NAME.md</code>.
* another pad is created for writing the stylesheet of your PDF. The name of the octomode environment will become the name of this pad, followed by .css. For example: <code>https://cc.practices.tools/pad/p/NAME.css</code>
* If both pads were not created yet, a template is added to the pad. The main pad will get a Markdown template and the stylesheet pad a CSS template.

In case a pad was already made, you can copy the templates below and paste them at the top of your pads.

The PDFs are rendered using [https://pagedjs.org/ Paged.js], a free and open source JavaScript library "that paginates content in the browser to create PDF output from any HTML content. This means you can design works for print (eg. books) using HTML and CSS!" The project used to be maintained by the [https://coko.foundation/ Coko Foundation] but is currently on its own feet! Paged.js adds not (yet) implemented CSS rules to the ones that browsers implemented already, expanding the possibilities to make lay outs for specific sections, place content in the margins of pages, and render indexes (amongst other things). The Paged.js documentation is very helpful and can be found here: https://pagedjs.org/documentation/.

==How to install octomode?==

[[Installing octomode]]

==CSS Print==

Some CSS Print examples can be found at: [[CSS Print]]

==Troubleshooting==

At the top of the pad for content is a metadata block:

---
title: octomode
language: en
---

When things go wrong in situations when many people are working together, it is often that someone has typed something at the start of the pad before the metadata block, or there is some syntax error in the metadata block. For example, using two colons in the title field will make it break:

---
title: My cool title: and subtitle
language: en
---

The title is only there to make the name of the PDF file when it is exported, and the language can be set to something other than English. But this metadata must be there, and there must be three hyphens (---) opening and closing the metadata block.

== Error log ==

For some adventures in Octomode, see the [[Error log]].

==Made with Octomode==

A partial collection of zines, publications, sticker sets and web posters made with octomode.

The list is not complete, but that's also not the point. It is here to give an idea what kind of things are made.

And it's also here as an archive of the practices that have grown around octomode.

<gallery widths=250 heights=300>
File:SomeTimes number-1.pdf|First edition of the ''[[SomeTimes]]'' by Varia (April, 2022)
File:Af-en-toe nummer-1.pdf|Eerste editie van de ''[[SomeTimes|Af en Toe]]'' by Varia (april, 2022)
File:SomeTimes number-3.pdf|Third edition of the ''[[SomeTimes]]'' made for the 12th of October Counter-Cloud Action day, by Varia (October, 2023)
File:Bulgarian-Antifascist-Bulletin 1 2023.pdf|''[[Bulgarian antifascist bulletin]]'' (2023)
File:ComputationalPublishingandWriting 2023.pdf|''[[the title is|the title is: (and then a series of checkboxes) (insert here your suggestions :} ) +1+1+1+1+1]]'', outcome of a workshop hosted by Winnie Soon and Geoff Cox (April, 2023)
File:Hosting-with-zine.pdf|''Hosting with]]'' self-published by Varia, made by Angeliki, Artemis and Manetta (July, 2023)
File:ATNOFS-screen.pdf|''[[A Traversal Network of Feminist Servers]]'' or ATNOFS in short, published by Varia, Hypha, Feminist Hack Meetings, Constant, esc, LURK (March 2023)
File:Free palestine reader.png|Front page of the [[Free palestine reader]]
File:Anarchokrant 4.png|Front page of the fourth edition of the [[Anarchokrant]]
File:Social-in-the-media-bw.pdf|''[[Social in the Media]]'', zine made by Varia, June 2024
File:Bulletin-6-0.jpg|''[[HD Bulletin]]'' 6 made by Hackers & Designers, February 2025
File:so-you-decided-to-make-a-zine.jpg|''[[so, you decided to make a zine using octomode]]'', a zine introducing how to work with octomode, made by Simon Browne during his residency in Ireland, June 2025
File:Constant-techno-disobedience-2023.pdf|[[Constant SPLINT zines]] issue #1: ''Techno-disobedience!'' made by Martino Morandi, Alix Turcq, Manetta Berends (December 2023)
File:Stickers-XPUB-Charlie.png|Sticker sheet made by Charlie during ''[[Special Issue 26: Declarations]]'', a thematic trimester project at [https://xpub.nl XPUB] (spring 2025)
File:XPUB-SI26-Declarations.png|Declarations web poster made collectively in octomode by the XPUB students + Doriane during ''[[Special Issue 26: Declarations]]'' (spring 2025)
File:So-you-decided-to-make-a-zine-in-octomode.pdf|''[[so, you decided to make a zine using octomode|so, you decided to make a zine in octomode]]'' second version! Made by Simon during the Des*gn Week in Linz (November, 2025)
File:Flyerconstanta2-82dd7.jpg|''Otherworldly Communications'' is the 3rd annual publication of the [[Constant SPLINT zines]], designed by Sarah Magnan, published in March 2026
</gallery>

==Versions of octomode==

===technodisobedience===

''2023''

[[File:Screenshot from 2025-06-17 12-44-37.png|left|thumb|new buttons!]]

[[File:Octomode-technodisobedience-4.png|left|thumb|the publication in CK mode]]

[[File:Octomode-technodisobedience-5.png|left|thumb|the same page in MYK mode]]

The art organisation Constant in BXL makes a publication to document their activities of that year and in 2023 they worked around the theme of technodisobedience: https://circulations.constantvzw.org/pub/constant-techno-disobedience-2023.pdf

As part of the publication making and thinking, i (Manetta) was invited to work with Martino on a publishing workflow and printed outcome. We worked on some tools that we in the end awkwardly (but with joy) called ''AGGREGARIOUSLY SNOWPLOWING devices'': a houtje-touwtje/cobbled-together workflow to publish snippets from pads (using ''snowpoles'') continuously throughout the year (using an ''aggregator''). We [https://circulations.constantvzw.org/pub/constant-techno-disobedience-2023.pdf#page=37 wrote about in the publication] too.

In the end, this annual publication was produced with the whole Constant team joined by Alix Turcq and myself, using a customized version of octomode installed on their server. The publication was RISO printed at Chez Rosi (a sweet printing place in BXL) which was a reason to add a color separation feature to octomode (!).

<blockquote>
The publication you are holding is instead the result of our step into octomode, a system that we trusted would allow us to have a publication for this year balancing collective workflows and experimental additions, but with a much more predictable timeline. In the case of this publication, we developed a custom version of octomode, that allows us to output different PDFs with color separation in view of our riso-printing at Chez Rosi in Brussel. To achieve the separation of colors, we made use of Imagemagick and a bunch of hacks in our css styles to make sure to generate both a riso simulation of the two color printing technique for the web version and the correct files to send to the risograph printer.
</blockquote>

The code is stored as a separate branch called [https://git.vvvvvvaria.org/CC/octomode/src/branch/technodisobedience/ <code>technodisobedience</code>].

<div style="clear:both;"></div>

===grilletti===

''2025''

[[File:Grilletti-epub-pxlhNQ0zT5etS075qwdjsQ.jpg|thumb|left|new octomode button: EPUB !!!]]

[[File:Grilletti-epub-2.png|thumb|left|second step in the EPUB generation feature]]

[[File:Grilletti-paste.png|thumb|left|another new octomode button: PASTE]]

During an italian hackmeeting the group C.I.R.C.E. laid out a book with octomode and did a short presentation on the process, "very beta".

A new button was added: EPUB (!), to generate an epub file directly from the octomode environment. When you click the button, it brings you to another page, where you can select a cover image before you generate the EPUB.

A second button was added too: PASTE, which seems to be a way to import markdown files from either your local computer, or stored online somewhere. Hmm!

The code will be pushed to the [https://git.vvvvvvaria.org/CC/octomode/src/branch/technodisobedience/ <code>technodisobedience</code>] branch.

<div style="clear:both;"></div>

===Learning Palestine===

''2025-2026''

[https://hackersanddesigners.nl/ Hackers & Designers] are working on a custom Octomode setup for the group [https://learningpalestine.net/ Learning Palestine], to support their (re)publishing efforts of texts "to disseminate knowledge on the history of the ongoing struggle for justice, liberation, and freedom of Palestine and the Palestinian People", outside of the hands of corporate platforms. At first they explored ways to do so without corporate social media platforms, but then also wanted to step away from corporate design tools such as Adobe InDesign.

They started to collaborate with Hackers & Designers to see what role Octomode can play in this great initiative, and for this H&D is working on some changes and new features to how etherpads work within Octomode, which they published as a plugin here: https://www.npmjs.com/package/ep_markdown_toc and documented here: https://etherpad.hackersanddesigners.nl/p/ep_plugins.

<div style="clear:both;"></div>