Administration First Steps (#105)

* Create first_steps.md

* spelling correction

* link correction

* Update first_steps.md

* updated to relative links when possible

* Update first_steps.md

* mentioned that federation is disabled by default

* added administration/first_steps.md

* typos
This commit is contained in:
retiolus 2021-10-16 10:48:46 +00:00 committed by GitHub
parent 16155e31d6
commit bfeeaa6121
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 39 additions and 0 deletions

View file

@ -9,6 +9,7 @@
- [Install with Ansible](administration/install_ansible.md)
- [Install from Scratch](administration/from_scratch.md)
- [Install on AWS](administration/on_aws.md)
- [First Steps](administration/first_steps.md)
- [Configuration](administration/configuration.md)
- [Getting started with Federation](administration/federation_getting_started.md)
- [Troubleshooting](administration/troubleshooting.md)

View file

@ -0,0 +1,38 @@
# Administration First Steps
After you successfully installed Lemmy either [manually with Docker](administration/install_docker.html) or [automatically with Ansible](administration/install_ansible.html) here are some recommendations for a new administrator of a Lemmy server.
## Admin Settings
The first thing to do is to go to your admin panel, which can be found by clicking on the cog at the top right next to the search icon. Here you can define a description for your site, so that people know if it is about one specific topic or if all subjects are welcome. You can also add an icon and a banner that define your server, it can for example be the logo of your organization.
Take the time to browse through the entire page to discover the different options you have to customize your Lemmy instance, on the same page you can edit your [configuration file](administration/configuration.html), where you can find information about your database, the email used by the server, the federation options or who is the main administrator.
It is always good to define another administrator than yourself, in case it is necessary to take actions while you take your best nap. Take a look at the [moderation guide](moderation/moderation.html) for more information on how to do this.
## Check that everything is working properly
### Federation
Federation is disabled by default, and needs to be enabled either through the online admin panel or directly through the `config.json` file.
To test that your instance federation is working correctly execute `curl -H 'Accept: application/activity+json' https://your-instance.com/u/your-username`, it should return json data, and not an .html file. If that is unclear to you, it should look similar to the output of `curl -H 'Accept: application/activity+json' https://lemmy.ml/u/nutomic`.
## Inclusion on join-lemmy.org instance list
To be included in the list of Lemmy instances on [join-lemmy.org](https://join-lemmy.org/instances) you must meet the following requirements:
- [x] Federate with at least one instance from the list
- [x] Have a site description and icon
- [x] Be patient and wait the site to be updated, there's no fixed schedule for that
In the meantime you can always promote your server on other social networks like Mastodon using the hashtag `#Lemmy`.
## Keeping up to date
You can subscribe to the Github RSS feeds to be informed of the latest releases:
- [lemmy](https://github.com/LemmyNet/lemmy/releases.atom)
- [lemmy-ui](https://github.com/LemmyNet/lemmy-ui/releases.atom)
- [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client/releases.atom)
- [joinlemmy-site](https://github.com/LemmyNet/joinlemmy-site/releases.atom)
There is also a [Matrix chat](https://matrix.to/#/!OwmdVYiZSXrXbtCNLw:matrix.org) for instance administrators that you can join. You'll find some really friendly people there who will help you (or at least try to) if you run into any issue.