You have to understand, not everyone is going to run their stuff the same way. Could documentation be better? Sure. But part of the fun is breaking everything and trying again. Hell, NCD went through like two weeks of "okay everyone make accounts whoops I have to wipe the database and start over because I have no fucking clue what I'm doing".
After all that, I still have no fucking idea what I'm doing but I'm taking a path to become a web developer because overcoming those obstacles is a reward in itself.
I don’t think that there are any more links because that’s basically it, unless there is a requirement for you to make custom builds, which you can find instructions for on the Gitlab repository.
Strictly speaking, that page has everything necessary for you to install it and get up and running, but it would definitely nice for there to be a PS: go to this.url for more info on administering and updating the instance as well as this link here to learn more about how the database works
The instructions I followed that I’m talking about are the ones you linked to. What I’m saying is that once you’ve followed those instructions to the end, there aren’t any immediately obvious links to resources as to how to do anything else. If you’re like me, a retard-tier Linux sysadmin, once you finish those instructions, the resources to learn how to maintain and administer the instance properly are not anywhere obvious on Soapbox.pub
This is the main one I’ve been looking at, but it took me some time to find information about updating Soapbox specifically, and it has very little info about postgres stuff. A couple links at least would be nice. I feel like I’m blind, feeling around in darkness for a lot of this info
The soapbox instructions do not implement the postgres apt repository.
speaking of which, @alex , do you think it would be worthwhile to add the following instructions so that users can get the latest version of Postgres when installing Soapbox? Might as well, since the fediverse is growing.
# Create the file repository configuration:
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
# Import the repository signing key:
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
# Update the package lists:
sudo apt-get update
# Install the latest version of PostgreSQL.
# If you want a specific version, use 'postgresql-12' or similar instead of 'postgresql':
sudo apt-get -y install postgresql
I think in general the Soapbox instructions could use some links to updating information. I’ve had to scour a few different documentation sites to learn anything at all, and I’ve helped another instance admin with the idiot-level knowledge I’ve gleamed
Ver Cluster Port Status Owner Data directory Log file 12 main 5432 online postgres /var/lib/postgresql/12/main /var/log/postgresql/postgresql-12-main.log
No no no. Right now you probably don’t have to pgtune but I would, for future proofing at least to an extent. PG is Postgres. Vacuuming happens automatically, but if you’re experiencing specific issues, you may want to run a vacuum. You can repack your database weekly using crontab, which is what we do every Sunday to continuously optimize things. Are you familiar with crontab?
Yeah, I have a few cronjobs set up for updating and such, but I haven’t done anything to the database yet because I don’t understand postgres well enough
Increase resources. Bigger server, more cores, more RAM. However, if your instance really doesn't do all that stuff, a PGTune should be fine. Have you done that yet?
As of right now, Kabuki Club is very snappy, but it’s pretty much just me and one other guy using it regularly. When more people start to register, keeping it that way becomes a much more severe problem
@balrog_booger@matty You’re not wrong. The site/docs will get some more love eventually, but there are more pressing problems in the codebase at the moment.
I mean, even linking to docs.pleroma.social would be a big improvement from the standpoint of the newbie. I don’t think that’s an unreasonable request. I had a good bit of Linux experience going into this, but a lot of people don’t