# mastodon-styles

Some styles for a mastodon server.

Should work on the root path of your mastodon instance. (/home/mastodon/live).

## My instance

I had a single-user instance running for about 4 months and I shut it down on
March 25 2023 because of different reasons.

I've been testing and playing around with that mastodon software but I only used
version 4.0.2 (I think) up to 4.1.1. Upgrades went very well, just read the release
docs.

I moved servers two times, first time only geographically but second time I went
to use a server with a smaller configuration setup (ram, harddisk size). This is
not something you do in your webinterface, you gonna move the files and database
by hand (an upgrade of harddisk size and RAM would be much easier on VPS systems).

Finally, I'd like to show you some stats and maybe some useful information.

### Some statistics

for a single user instance with 4 relais (1 of them was only ham radio related, so
the traffic on that one was very low). The other three relais made sidekiq to work
~8x more than before the relais.

```console
$ bin/tootctl media usage
Attachments:	16.1 GB (1.94 MB local)
Custom emoji:	87.2 MB (450 KB local)
Preview cards:	1.02 GB
Avatars:	2.3 GB (48.5 KB local)
Headers:	5.33 GB (429 KB local)
Backups:	0 Bytes
Imports:	0 Bytes
Settings:	0 Bytes
```

![admin dashboard showing usage](admin.png)

### (Hopefully) helpful snippets

#### clear media files

<https://paste.opensuse.org/pastes/365542654a1e>

```bash
#!/bin/bash
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
export RAILS_ENV=production

exec > /home/mastodon/live/log/prune.log 2>&1

/home/mastodon/live/bin/tootctl statuses remove
/home/mastodon/live/bin/tootctl media remove --days=5
/home/mastodon/live/bin/tootctl media remove --prune-profiles --days=60
/home/mastodon/live/bin/tootctl preview_cards remove --days=15
/home/mastodon/live/bin/tootctl media remove-orphans
/home/mastodon/live/bin/tootctl cache clear
/home/mastodon/live/bin/tootctl media usage
date
```

#### profile pics

<https://paste.opensuse.org/pastes/4ecbf69cdee7>

```bash
#!/usr/bin/env bash
# Kept only the accounts compression and jpeg optimization

cd /home/mastodon/live/public/system/cache
find -name '*.jpg' -print0 | xargs -0 jpegoptim --verbose --preserve --threshold=1 --max=45
find -name '*.jpeg' -print0 | xargs -0 jpegoptim --verbose --preserve --threshold=1 --max=45

cd /home/mastodon/live/public/system/cache/accounts
find -name '*.png' -print0 | xargs -0 pngquant --verbose --ext=.png --force --speed 10 --quality 45-50 --skip-if-larger
```

#### managing media in rails console

<https://github.com/mastodon/mastodon/issues/14681>

There are several scripts executable with `RAILS_ENV=production bundle exec rails c`,
for convenience laid out here with minor corrections. **Do not execute these
without understanding what they do!**:

Deleting all cached media attachments from external servers to allow web app
to refetch them when they are queried. At least on my instance this is reaaally
slow, takes tens of seconds per attachment (is this the same as tootctl media
remove?):

```ruby
MediaAttachment.cached.where.not(remote_url: '').each do |attachment|
  attachment.file.destroy
  attachment.thumbnail.destroy
  attachment.save
end
```

Deleting and redownloading all cached remote emojis. This apparently has a
problem that the local URLs for the cached emojis change, and the URLs aren't
updated to the fetched profile headers. I suppose this should be done before
the next steps, assuming the cached local emoji URLs are set up correctly to
the profile headers and names at the time of fetching. This doesn't seem to
work though, maybe tootctl emoji purge --remote-only would be better:

```ruby
CustomEmoji.remote.where.not(image_file_name: nil).where.not(image_remote_url: '').each do |emoji|
  emoji.image.destroy
  emoji.image.save
  emoji.download_image!
end
```

Deleting all remote profile avatars, and refetching them. Are these two the
same as tootctl accounts refresh --all?:

```ruby
Account.remote.where.not(avatar_file_name: nil).where.not(avatar_remote_url: '').each do |a|
  a.avatar.destroy
  a.save
  a.download_avatar!
end
```

Deleting all remote profile headers, and refetching them. Hopefully this
uses/updates the newly fetched local cached emoji URLs, and also includes the
profile name as they often contain emojis:

```ruby
Account.remote.where.not(header_file_name: nil).where.not(header_remote_url: '').each do |a|
  a.header.destroy
  a.save
  a.download_header!
end
```

It would be awesome to get tooling for these to tootctl. That said, I'm not
entirely sure if destroying the entities is necessary before downloading them
again, and perhaps we could use remove_entity_cache instead. I'm not very well
acquainted with the codebase.