mirror of
https://github.com/YunoHost-Apps/gotosocial_ynh.git
synced 2024-09-03 19:16:06 +02:00
83 lines
No EOL
3.5 KiB
Markdown
83 lines
No EOL
3.5 KiB
Markdown
<!--
|
|
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
|
|
It shall NOT be edited by hand.
|
|
-->
|
|
|
|
# GoToSocial for YunoHost
|
|
|
|
[](https://dash.yunohost.org/appci/app/gotosocial)  
|
|
[](https://install-app.yunohost.org/?app=gotosocial)
|
|
|
|
*[Lire ce readme en français.](./README_fr.md)*
|
|
|
|
> *This package allows you to install GoToSocial quickly and simply on a YunoHost server.
|
|
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
|
|
|
|
## Overview
|
|
|
|
GoToSocial is an ActivityPub social network server, written in Golang. With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
|
|
|
|
**Shipped version:** 0.2.1~ynh1
|
|
|
|
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
## Disclaimers / important information
|
|
|
|
* Any known limitations, constrains or stuff not working, such as (but not limited to):
|
|
* GoToSocial require a dedicated root domain, eg. gotosocial.domain.tld
|
|
* This package is not-working single-sign on or LDAP integration
|
|
* This package is currently set to single-instance that means you can run a single GoToSocial instance on a single server.
|
|
|
|
## Create and confirm your user
|
|
|
|
You can use the GoToSocial binary to also create, confirm, and promote your user account.
|
|
|
|
Run the following command to create a new account:
|
|
|
|
```bash
|
|
./gotosocial --config-path ./config.yaml admin account create --username some_username --email some_email@whatever.org --password SOME_PASSWORD
|
|
```
|
|
|
|
In the above command, replace `some_username` with your desired username, `some_email@whatever.org` with the email address you want to associate with your account, and `SOME_PASSWORD` with a secure password.
|
|
|
|
Run the following command to confirm the account you just created:
|
|
|
|
```bash
|
|
./gotosocial --config-path ./config.yaml admin account confirm --username some_username
|
|
```
|
|
|
|
Replace `some_username` with the username of the account you just created.
|
|
|
|
If you want your user to have admin rights, you can promote them using a similar command:
|
|
|
|
```bash
|
|
./gotosocial --config-path ./config.yaml admin account promote --username some_username
|
|
```
|
|
|
|
Replace `some_username` with the username of the account you just created.
|
|
|
|
## Documentation and resources
|
|
|
|
* Official app website: https://docs.gotosocial.org/
|
|
* Official user documentation: https://docs.gotosocial.org/en/latest/
|
|
* Official admin documentation: https://docs.gotosocial.org/en/latest/
|
|
* Upstream app code repository: https://github.com/superseriousbusiness/gotosocial
|
|
* YunoHost documentation for this app: https://yunohost.org/app_gotosocial
|
|
* Report a bug: https://github.com/YunoHost-Apps/gotosocial_ynh/issues
|
|
|
|
## Developer info
|
|
|
|
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/gotosocial_ynh/tree/testing).
|
|
|
|
To try the testing branch, please proceed like that.
|
|
```
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/gotosocial_ynh/tree/testing --debug
|
|
or
|
|
sudo yunohost app upgrade gotosocial -u https://github.com/YunoHost-Apps/gotosocial_ynh/tree/testing --debug
|
|
```
|
|
|
|
**More info regarding app packaging:** https://yunohost.org/packaging_apps |